Docs / Referencia de la APIAPI referenceMarkdown

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#

RutaQué haceCréditos
GET/v1/products/searchBuscar productos por texto1 per page of up to 20 results; 0 when nothing is found
GET/v1/productsListar productos con filtros exactos1 per 20 products returned
GET/v1/products/{product_id}Obtener un producto1

Precios#

RutaQué haceCréditos
GET/v1/products/{product_id}/pricesPrecios actuales de un producto en cada tienda1 per retailer offer returned
GET/v1/products/{product_id}/historyHistorial de precios de un producto1 per 30 points per series (minimum 1 per series)
POST/v1/prices/compareComparar una canasta entre tiendas1 per price in the matrix (product × retailer with data)
POST/v1/prices/batchPrecios de muchos productos u ofertas en una llamada1 per offer price returned; items not found cost 0
POST/v1/live-checksPedir una revisión de precio en vivo (planificado)10 per offer refreshed

Ofertas#

RutaQué haceCréditos
GET/v1/offersListar ofertas de las tiendas1 per offer returned
GET/v1/offers/{offer_id}Obtener una oferta con su precio actual1
GET/v1/offers/{offer_id}/historyObservaciones de una oferta1 per 30 points (minimum 1)

Referencia y cobertura#

RutaQué haceCréditos
GET/v1/retailersListar tiendas0
GET/v1/retailers/{retailer_id}Obtener una tienda0
GET/v1/storesListar locales físicos y puntos de retiro0
GET/v1/categoriesTaxonomía de categorías0
GET/v1/brandsListar marcas0
GET/v1/coverageQué datos hay disponibles0
GET/v1/countriesPaíses, monedas e idiomas0
GET/v1/fxTipo de cambio usado en las conversiones0
GET/v1/statusEstado del servicio y frescura de los datos0
GET/v1/public/coverageCobertura agregada, sin key y sin precios0

Cuenta#

RutaQué haceCréditos
GET/v1/accountPlan y saldo de la key0
GET/v1/usageCréditos consumidos0
POST/v1/data-requestsPedir cobertura o datos que no existen0

Exportaciones#

RutaQué haceCréditos
POST/v1/exportsCrear 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#

PathWhat it doesCredits
GET/v1/products/searchSearch products by text1 per page of up to 20 results; 0 when nothing is found
GET/v1/productsList products by exact filters1 per 20 products returned
GET/v1/products/{product_id}Get a product1

Prices#

PathWhat it doesCredits
GET/v1/products/{product_id}/pricesCurrent prices of a product at every retailer1 per retailer offer returned
GET/v1/products/{product_id}/historyPrice history of a product1 per 30 points per series (minimum 1 per series)
POST/v1/prices/compareCompare a basket of products across retailers1 per price in the matrix (product × retailer with data)
POST/v1/prices/batchCurrent prices for many products or offers in one call1 per offer price returned; items not found cost 0
POST/v1/live-checksRequest a live price check (planned)10 per offer refreshed

Offers#

PathWhat it doesCredits
GET/v1/offersList retailer offers1 per offer returned
GET/v1/offers/{offer_id}Get an offer with its current price1
GET/v1/offers/{offer_id}/historyObservations of a single offer1 per 30 points (minimum 1)

Reference and coverage#

PathWhat it doesCredits
GET/v1/retailersList retailers0
GET/v1/retailers/{retailer_id}Get a retailer0
GET/v1/storesList physical stores and pickup points0
GET/v1/categoriesCategory taxonomy0
GET/v1/brandsList brands0
GET/v1/coverageWhat data is available0
GET/v1/countriesCountries, currencies and languages0
GET/v1/fxExchange rate used for conversions0
GET/v1/statusService status and data freshness0
GET/v1/public/coverageAggregated coverage without prices (no key)0

Account#

PathWhat it doesCredits
GET/v1/accountPlan and credit balance of the calling key0
GET/v1/usageCredits consumed, grouped by day, operation, channel or key0
POST/v1/data-requestsAsk for coverage or data that is not available0

Exports#

PathWhat it doesCredits
POST/v1/exportsCreate a bulk export (planned)1 per 10 rows
GET/v1/exports/{export_id}Get an export job (planned)0