Referencia de la API
Generada del OpenAPI 3.1 (también en JSON). URL base: https://pricto.dev/v1. Autenticación: Authorization: Bearer <key> (ver Autenticación). Las descripciones de cada operación y campo están en inglés, como en el contrato.
Productos#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
GET | /v1/products/search | Buscar productos por texto | 1 per page of up to 20 results; 0 when nothing is found |
GET | /v1/products | Listar productos con filtros exactos | 1 per 20 products returned |
GET | /v1/products/{product_id} | Obtener un producto | 1 |
Precios#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
GET | /v1/products/{product_id}/prices | Precios actuales de un producto en cada tienda | 1 per retailer offer returned |
GET | /v1/products/{product_id}/history | Historial de precios de un producto | 1 per 30 points per series (minimum 1 per series) |
POST | /v1/prices/compare | Comparar una canasta entre tiendas | 1 per price in the matrix (product × retailer with data) |
POST | /v1/prices/batch | Precios de muchos productos u ofertas en una llamada | 1 per offer price returned; items not found cost 0 |
POST | /v1/live-checks | Pedir una revisión de precio en vivo (planificado) | 10 per offer refreshed |
Ofertas#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
GET | /v1/offers | Listar ofertas de las tiendas | 1 per offer returned |
GET | /v1/offers/{offer_id} | Obtener una oferta con su precio actual | 1 |
GET | /v1/offers/{offer_id}/history | Observaciones de una oferta | 1 per 30 points (minimum 1) |
Referencia y cobertura#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
GET | /v1/retailers | Listar tiendas | 0 |
GET | /v1/retailers/{retailer_id} | Obtener una tienda | 0 |
GET | /v1/stores | Listar locales físicos y puntos de retiro | 0 |
GET | /v1/categories | Taxonomía de categorías | 0 |
GET | /v1/brands | Listar marcas | 0 |
GET | /v1/coverage | Qué datos hay disponibles | 0 |
GET | /v1/countries | Países, monedas e idiomas | 0 |
GET | /v1/fx | Tipo de cambio usado en las conversiones | 0 |
GET | /v1/status | Estado del servicio y frescura de los datos | 0 |
GET | /v1/public/coverage | Cobertura agregada, sin key y sin precios | 0 |
Cuenta#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
GET | /v1/account | Plan y saldo de la key | 0 |
GET | /v1/usage | Créditos consumidos | 0 |
POST | /v1/data-requests | Pedir cobertura o datos que no existen | 0 |
Exportaciones#
| Ruta | Qué hace | Créditos | |
|---|---|---|---|
POST | /v1/exports | Crear una exportación masiva (planificado) | 1 per 10 rows |
GET | /v1/exports/{export_id} | Obtener una exportación (planificado) | 0 |
API reference
Generated from OpenAPI 3.1 (also as JSON). Base URL: https://pricto.dev/v1. Authentication: Authorization: Bearer <key> (see Authentication).
Products#
| Path | What it does | Credits | |
|---|---|---|---|
GET | /v1/products/search | Search products by text | 1 per page of up to 20 results; 0 when nothing is found |
GET | /v1/products | List products by exact filters | 1 per 20 products returned |
GET | /v1/products/{product_id} | Get a product | 1 |
Prices#
| Path | What it does | Credits | |
|---|---|---|---|
GET | /v1/products/{product_id}/prices | Current prices of a product at every retailer | 1 per retailer offer returned |
GET | /v1/products/{product_id}/history | Price history of a product | 1 per 30 points per series (minimum 1 per series) |
POST | /v1/prices/compare | Compare a basket of products across retailers | 1 per price in the matrix (product × retailer with data) |
POST | /v1/prices/batch | Current prices for many products or offers in one call | 1 per offer price returned; items not found cost 0 |
POST | /v1/live-checks | Request a live price check (planned) | 10 per offer refreshed |
Offers#
| Path | What it does | Credits | |
|---|---|---|---|
GET | /v1/offers | List retailer offers | 1 per offer returned |
GET | /v1/offers/{offer_id} | Get an offer with its current price | 1 |
GET | /v1/offers/{offer_id}/history | Observations of a single offer | 1 per 30 points (minimum 1) |
Reference and coverage#
| Path | What it does | Credits | |
|---|---|---|---|
GET | /v1/retailers | List retailers | 0 |
GET | /v1/retailers/{retailer_id} | Get a retailer | 0 |
GET | /v1/stores | List physical stores and pickup points | 0 |
GET | /v1/categories | Category taxonomy | 0 |
GET | /v1/brands | List brands | 0 |
GET | /v1/coverage | What data is available | 0 |
GET | /v1/countries | Countries, currencies and languages | 0 |
GET | /v1/fx | Exchange rate used for conversions | 0 |
GET | /v1/status | Service status and data freshness | 0 |
GET | /v1/public/coverage | Aggregated coverage without prices (no key) | 0 |
Account#
| Path | What it does | Credits | |
|---|---|---|---|
GET | /v1/account | Plan and credit balance of the calling key | 0 |
GET | /v1/usage | Credits consumed, grouped by day, operation, channel or key | 0 |
POST | /v1/data-requests | Ask for coverage or data that is not available | 0 |
Exports#
| Path | What it does | Credits | |
|---|---|---|---|
POST | /v1/exports | Create a bulk export (planned) | 1 per 10 rows |
GET | /v1/exports/{export_id} | Get an export job (planned) | 0 |