API de datos de precios: accede a los datos de monitorización desde tus propios sistemas
La API REST de 4pricing.net permite a tu equipo técnico llevar los datos de monitorización de precios a tus propios sistemas (por ejemplo, un ERP, un WMS o una tienda online). 4pricing no ofrece conectores ya hechos: el enlace lo construye tu desarrollador sobre la API. La autenticación se realiza con una clave de API, las respuestas son JSON estándar y la especificación se publica en OpenAPI 3.0, lista para importar en tu cliente.
Endpoints principales
La API expone los datos de monitorización a nivel de producto monitorizado: la lista de productos con su precio actual, el histórico de precios de un producto y un minihistórico masivo para las vistas de lista. Los productos se identifican por el product_id que se devuelve al añadirlos: ese identificador es la clave de ruta. Los importes llegan en unidades menores, en los campos current_price_cents y price_cents, junto con la moneda, y cada registro incluye la hora exacta de la comprobación (last_scraped_at y scraped_at, respectivamente).
- GET /products/ — tus productos monitorizados, con precio actual y moneda
- GET /products/{product_id}/history — el histórico de precios de un producto, con marcas de tiempo
- GET /products/sparklines — minihistórico masivo, una serie de precios por producto
- POST /alerts/ — crear una alerta (umbral, caída porcentual, stock, competidor)
Autenticación y límite de peticiones
La autenticación se realiza con la cabecera X-API-Key o, de forma equivalente, con Authorization: Bearer y la misma clave. Las claves se generan desde el panel, en la sección API y claves, y su valor completo se muestra una sola vez, al crearla. El límite es de 60 peticiones por minuto y cuenta, compartido por todas tus claves; al superarlo, la API responde 429 y envía la cabecera Retry-After.
Ventajas y limitaciones
Ventajas
- Tu equipo puede alimentar su propio ERP/WMS directamente desde la API, sin exportación manual a CSV (el conector lo construyes tú)
- Las alertas pueden enviarse por webhook, así que no tienes que hacer sondeos
- Especificación OpenAPI 3.0 publicada, lista para importar en tu cliente
- Acceso al precio recomendado para el grupo de comparación, no solo a los datos en bruto
Limitaciones
- El límite de 60 peticiones/minuto por cuenta (compartido por todas las claves) obliga a lecturas masivas y caché local en catálogos grandes
- El webhook requiere una URL http/https pública (puerto 80/443) en tu infraestructura
Veredicto rápido
La API cubre la lectura de los datos de monitorización y del precio recomendado, el envío de tus propios precios y la aplicación del precio recomendado, pero no incluye conectores para ERP ni tienda. Los catálogos grandes se benefician de las lecturas masivas (paginación, minihistórico masivo) y de la caché local.
Tabla de especificaciones
| Endpoint | Método | Respuesta |
|---|---|---|
| /products/ | GET | Array JSON de productos monitorizados, con current_price_cents |
| /products/{product_id}/history | GET | Array JSON del histórico con marcas de tiempo |
| /products/sparklines | GET | JSON con una serie de precios por producto |
| /alerts/ | POST | La alerta creada, con su tipo y su umbral |
API frente a exportación CSV bajo demanda
| Criterio | API REST | Exportación CSV |
|---|---|---|
| Latencia de los datos | Los datos son los de la última comprobación | Datos del momento de la descarga |
| Conexión con el ERP | Por HTTP, con un conector que escribe tu equipo | Importación manual o por cron |
| Alertas push | Sí (webhook) | No |
Preguntas frecuentes
¿Cómo obtengo una clave de API?
La clave se genera desde el panel de tu cuenta de 4pricing.net, en la sección API y claves. El valor completo se muestra una sola vez, al crearla: si la pierdes, revoca la clave y genera otra.
¿Puedo acceder a los datos de todos los productos a la vez?
Sí: GET /products/?skip=0&limit=200 permite paginar todo el catálogo monitorizado, y el número total de filas llega en la cabecera X-Total-Count. Para listas largas, GET /products/sparklines devuelve el minihistórico de varios productos en una sola llamada. Recomendamos una sincronización nocturna para catálogos grandes y lecturas más frecuentes solo de los productos que de verdad importan.
¿Qué formato tiene el histórico de precios que devuelve la API?
Un array JSON de objetos {product_id, price_cents, currency, in_stock, scraped_at}, ordenados de forma descendente por fecha. El precio llega en unidades menores (price_cents), no en unidades enteras de moneda, y scraped_at es una marca de tiempo ISO 8601 exacta.
¿Qué eventos envía el webhook?
Hay una URL de webhook por cuenta, y recibe todos los tipos de alerta que crees: precio por debajo de un umbral, precio por encima de un umbral, caída porcentual, vuelta de stock, un competidor que te baja el precio y pérdida de la posición de precio más bajo. No existe una alerta sobre el suelo de coste como tal.