Documentación de la API de Búsqueda de Productos - SP-SpareParts

Descripción

Esta API permite realizar búsquedas de productos en la base de datos de SP-SpareParts. La llamada es sencilla y no requiere autenticación ni parámetros especiales más allá de la consulta de búsqueda. Se trata de una API REST que devuelve resultados en formato JSON. Además, se puede realizar una búsqueda directa desde el navegador para obtener resultados en formato HTML.

---

Acceso API (JSON)

Para obtener resultados en formato JSON:

https://www.sp-recambios.es/es/s/api?query=[query]

Acceso directo desde navegador (HTML)

Para obtener resultados en formato HTML:

https://www.sp-recambios.es/es/search?query=[query]

Método

GET

Parámetros de la consulta

• [query] (obligatorio): Texto de búsqueda del producto que se desea consultar. Ejemplo: R165139370

Ejemplo de Llamada

https://www.sp-recambios.es/es/s/api?query=R165139370

---

Respuesta (JSON)

La API devuelve un objeto JSON con información relevante sobre el producto buscado. A continuación se muestra un ejemplo de respuesta:

{
    "items": [
        {
            "id": 297800,
            "url": "https:\/\/www.sp-recambios.es\/es\/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"
                }
            ]
        }
    ]
}

Campos de la Respuesta

• items: Lista de productos encontrados (puede ser vacía si no hay resultados). Cada producto incluye:
• items[].id: Identificador único del producto.
• items[].url: URL de acceso al producto en la web.
• items[].price: Precio unitario del producto.
• items[].search: Término de búsqueda relacionado.
• items[].availability: Disponibilidad del producto (ej. "available", "limited stock").
• items[].partnumber: Código del producto.
• items[].imageurl: URL de la imagen del producto.
• items[].catalognumber: Número de catálogo del producto.
• items[].brand: Información sobre la marca (nombre e id).
• items[].category: Categoría del producto y su ruta jerárquica.
• items[].attributes: Lista de atributos relacionados con el producto (nombre y valor).

Código de Error

Si no se encuentran productos con la consulta dada, la respuesta puede ser una lista vacía o un mensaje de error personalizado.

---

Notas adicionales

• La API responde rápidamente y no requiere autenticación.