Product Search API Documentation - SP-SpareParts

Description

This API allows you to search for products in the SP-SpareParts database. The call is straightforward and does not require authentication or special parameters other than the search query. It is a REST API that returns results in JSON format. Additionally, a direct search from the browser can be performed to obtain results in HTML format.

---

API Access (JSON)

To retrieve results in JSON format:

https://www.sp-spareparts.com/en/s/api?query=[query]

Direct Access from Browser (HTML)

To retrieve results in HTML format:

https://www.sp-spareparts.com/en/search?query=[query]

Method

GET

Query Parameters

• [query] (required): The product search text. Example: R165139370

Example Call

https://www.sp-spareparts.com/en/s/api?query=R165139370

---

Response (JSON)

The API returns a JSON object with relevant information about the searched product. Below is an example of a response:

{
    "items": [
        {
            "id": 297800,
            "url": "https:\/\/www.sp-spareparts.com\/en\/p\/r165139370-bosch-rexroth?_q=R165139370",
            "price": "$373.16",
            "search": "R165139370 REXROTH",
            "availability": "available",
            "partnumber": "R165139370",
            "imageurl": "https:\/\/cdn.sp-spareparts.com\/assets\/img\/category\/bosch\/category-112.big.jpg",
            "catalognumber": "KWD-035-FNS-C0-H-1",
            "brand": {
                "id": 27,
                "name": "REXROTH"
            },
            "category": {
                "name": "FNS, standard, Resist NR II, with ball chain",
                "path": "linear motion technology > profiled rail systems > ball rail systems > ball runner blocks > fns, standard, resist nr ii, with ball chain"
            },
            "attributes": [
                {
                    "name": "Size",
                    "value": "35"
                },
                {
                    "name": "Preload class",
                    "value": "C0"
                },
                {
                    "name": "Accuracy class",
                    "value": "H"
                },
                {
                    "name": "Weight",
                    "value": "1.70Kg"
                }
            ]
        }
    ]
}

Response Fields

• items: List of products found (can be empty if no results are found). Each product includes:
• items[].id: Unique product identifier.
• items[].url: URL to access the product on the website.
• items[].price: Product's unit price.
• items[].search: Related search term.
• items[].availability: Product availability (e.g., "available", "limited stock").
• items[].partnumber: Product code.
• items[].imageurl: URL to the product's image.
• items[].catalognumber: Product catalog number.
• items[].brand: Information about the brand (name and id).
• items[].category: Product category and its hierarchical path.
• items[].attributes: List of related product attributes (name and value).

Error Code

If no products are found with the given query, the response may be an empty list or a custom error message.

---

Additional Notes

• The API responds quickly and does not require authentication.