Product Data API · v1
Datos de productos y precios por EAN y ASIN
Una API REST comercial: envía un EAN/GTIN o un ASIN y obtén el producto junto con los precios actuales de todas las tiendas, estadísticas de precios y disponibilidad. Ideal para webs comparadoras, apps, repricing y agentes de IA.
Para agentes de IA y LLM: especificación legible por máquina en /api/v1/openapi.json (OpenAPI 3.1) y un resumen en /llms.txt. Autenticación: cabecera x-api-key. Endpoint principal: GET /api/v1/lookup?ean=|asin=.
Planes
Cada solicitud autenticada cuenta contra tu cuota mensual. Si la superas, la API responde con 402.
Autenticación
Envía tu clave en la cabecera x-api-key. Cada respuesta incluye X-Plan, X-Quota-Limit y X-Quota-Remaining.
Lookup por EAN / ASIN
El endpoint principal: datos de precios de un identificador.
Solicitud
curl -H "x-api-key: YOUR_KEY" \ "https://api.nidoprecio.es/api/v1/lookup?ean=4006381333931"
Respuesta
{
"data": {
"identifier": { "ean": "4006381333931", "asin": "B0...", "mpn": "..." },
"product": { "name": "...", "brand": "...", "url": "..." },
"priceStats": { "currency": "EUR", "min": 1299.0, "max": 1499.0,
"lowestEver": 1249.0, "offerCount": 6 },
"offers": [
{ "merchant": "MediaMarkt", "totalPrice": 1299.0,
"availability": "in_stock", "url": ".../go/123" }
]
}
}Endpoints
| Método | Ruta | Descripción | Auth |
|---|---|---|---|
| GET | /api/v1/lookup?ean= | asin= | ★ Producto + todos los precios de las tiendas por EAN/GTIN o ASIN | Clave de API |
| GET | /api/v1/products?q=&category=&brand=&sort= | Buscar y filtrar productos | Clave de API |
| GET | /api/v1/products/{slug} | Detalle del producto con ofertas | Clave de API |
| GET | /api/v1/products/{id}/offers | Todas las ofertas de un producto | Clave de API |
| GET | /api/v1/products/{id}/price-history?days=90 | Historial de precios | Clave de API |
| GET | /api/v1/categories · /brands · /merchants | Datos maestros | Clave de API |
| GET | /api/v1/articles | Artículos de las guías | Clave de API |
| GET | /api/v1/plans · /openapi.json | Planes y especificación OpenAPI (público) | público |
Códigos de estado
| 401 | Clave de API ausente o no válida (cabecera x-api-key). |
| 402 | Cuota mensual agotada: mejora tu plan. |
| 404 | No se ha encontrado ningún producto para este EAN/ASIN. |
| 429 | Se ha superado el límite de peticiones (solicitudes por minuto). |
Preguntas frecuentes
- ¿Cómo obtengo los precios de un producto por EAN o ASIN?
- Envía GET /api/v1/lookup?ean=<EAN> o ?asin=<ASIN> con tu clave de API en la cabecera x-api-key. La respuesta incluye el producto, estadísticas de precios y todas las ofertas de las tiendas con el precio total.
- ¿Cuánto cuesta la Product Data API de Nidoprecio?
- Hay un plan Free gratuito con 100 solicitudes al mes, así como Starter (29 €, 10.000), Pro (99 €, 100.000) y Enterprise (ilimitado, a consultar).
- ¿Cómo se factura el uso?
- Cada solicitud autenticada cuenta contra la cuota mensual de tu plan. El contador se restablece al inicio de cada mes natural. Si se supera, la API responde con HTTP 402.
- ¿Hay una especificación legible por máquina?
- Sí, una especificación OpenAPI 3.1 en /api/v1/openapi.json y un resumen optimizado para LLM en /llms.txt.