Listar productos con filtros exactos
GET
https://pricto.dev/v1/productsFilter the catalog by identifiers, brand or category. Use /products/search for free text.
| Créditos | MCP |
|---|---|
| 1 per 20 products returned | — |
Parámetros#
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
max_credits | query | number | Spend at most this many credits on this call. Results are cut to fit and meta.usage.truncated is true. |
dry_run | query | boolean | Return the quote in meta.usage with data set to null, without charging. Default: false. |
gtin | query | string | One or more GTIN/EAN codes, comma separated (max 100). |
country | query | string | ISO 3166-1 alpha-2 country code. Defaults to all covered countries. |
category | query | string | Category ID; includes subcategories (e.g. food.dairy). |
brand | query | string | Brand ID or name. |
retailer | query | string | One or more retailer IDs, comma separated (e.g. cl-jumbo,cl-unimarc). |
lang | query | string | Response language as a BCP 47 tag (es, es-CL, en, en-US...). Supported today: es, en. An unsupported language falls back to English with a warning, never an error. Falls back to Accept-Language, then to the account default. The resolved value is in meta.lang. |
currency | query | string | Add converted amounts in this ISO 4217 currency. local (default) returns source currency only. Default: local. |
limit | query | integer | Default: 50. |
cursor | query | string | Opaque cursor from pagination.next_cursor. |
format | query | string | json (default) or csv. Equivalent to Accept: text/csv. Valores / values: json, csv. Default: json. |
Respuesta#
200 Products.
| Campo | Tipo | Descripción |
|---|---|---|
data requerido | ProductSummary[] | |
data[].id requerido | string | |
data[].name requerido | string | |
data[].brand requerido | BrandRef | |
data[].brand.id requerido | string | |
data[].brand.name requerido | string | |
data[].category requerido | CategoryRef | |
data[].category.id requerido | string | |
data[].category.label requerido | string | |
data[].category.path | string[] | |
data[].size | object | |
data[].gtin | string[] | |
data[].image_url | string | null | |
data[].price_summary requerido | PriceSummary | |
data[].price_summary.currency requerido | string | |
data[].price_summary.min requerido | number | null | |
data[].price_summary.max requerido | number | null | |
data[].price_summary.median | number | null | |
data[].price_summary.offers_count requerido | integer | |
data[].price_summary.retailers_count requerido | integer | |
data[].price_summary.best | object | null | |
data[].price_summary.best.retailer | RetailerRef | |
data[].price_summary.best.offer_id | string | |
data[].price_summary.best.price | number | |
data[].price_summary.observed_at | string (date-time) | null | |
data[].price_summary.converted | object | |
data[].price_summary.converted.currency | string | |
data[].price_summary.converted.min | number | null | |
data[].price_summary.converted.max | number | null | |
data[].price_summary.converted.fx_rate | number | |
data[].price_summary.converted.fx_date | string (date) | |
data[].price_summary.converted.fx_source | string | |
data[].price_summary.converted.fx_method | string | Valores / values: direct, cross. |
data[].score | number | Relevance score, search only. |
pagination requerido | Pagination | |
pagination.has_more requerido | boolean | |
pagination.next_cursor requerido | string | null | |
meta requerido | Meta |
meta trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver Convenciones).
Errores#
List products by exact filters
GET
https://pricto.dev/v1/productsFilter the catalog by identifiers, brand or category. Use /products/search for free text.
| Credits | MCP |
|---|---|
| 1 per 20 products returned | — |
Parameters#
| Parameter | In | Type | Description |
|---|---|---|---|
max_credits | query | number | Spend at most this many credits on this call. Results are cut to fit and meta.usage.truncated is true. |
dry_run | query | boolean | Return the quote in meta.usage with data set to null, without charging. Default: false. |
gtin | query | string | One or more GTIN/EAN codes, comma separated (max 100). |
country | query | string | ISO 3166-1 alpha-2 country code. Defaults to all covered countries. |
category | query | string | Category ID; includes subcategories (e.g. food.dairy). |
brand | query | string | Brand ID or name. |
retailer | query | string | One or more retailer IDs, comma separated (e.g. cl-jumbo,cl-unimarc). |
lang | query | string | Response language as a BCP 47 tag (es, es-CL, en, en-US...). Supported today: es, en. An unsupported language falls back to English with a warning, never an error. Falls back to Accept-Language, then to the account default. The resolved value is in meta.lang. |
currency | query | string | Add converted amounts in this ISO 4217 currency. local (default) returns source currency only. Default: local. |
limit | query | integer | Default: 50. |
cursor | query | string | Opaque cursor from pagination.next_cursor. |
format | query | string | json (default) or csv. Equivalent to Accept: text/csv. Valores / values: json, csv. Default: json. |
Response#
200 Products.
| Field | Type | Description |
|---|---|---|
data required | ProductSummary[] | |
data[].id required | string | |
data[].name required | string | |
data[].brand required | BrandRef | |
data[].brand.id required | string | |
data[].brand.name required | string | |
data[].category required | CategoryRef | |
data[].category.id required | string | |
data[].category.label required | string | |
data[].category.path | string[] | |
data[].size | object | |
data[].gtin | string[] | |
data[].image_url | string | null | |
data[].price_summary required | PriceSummary | |
data[].price_summary.currency required | string | |
data[].price_summary.min required | number | null | |
data[].price_summary.max required | number | null | |
data[].price_summary.median | number | null | |
data[].price_summary.offers_count required | integer | |
data[].price_summary.retailers_count required | integer | |
data[].price_summary.best | object | null | |
data[].price_summary.best.retailer | RetailerRef | |
data[].price_summary.best.offer_id | string | |
data[].price_summary.best.price | number | |
data[].price_summary.observed_at | string (date-time) | null | |
data[].price_summary.converted | object | |
data[].price_summary.converted.currency | string | |
data[].price_summary.converted.min | number | null | |
data[].price_summary.converted.max | number | null | |
data[].price_summary.converted.fx_rate | number | |
data[].price_summary.converted.fx_date | string (date) | |
data[].price_summary.converted.fx_source | string | |
data[].price_summary.converted.fx_method | string | Valores / values: direct, cross. |
data[].score | number | Relevance score, search only. |
pagination required | Pagination | |
pagination.has_more required | boolean | |
pagination.next_cursor required | string | null | |
meta required | Meta |
meta carries the cost, the source line to quote, the language, the currency and notices (see Conventions).