Obtener un producto
GET
https://pricto.dev/v1/products/{product_id}Get a product
| Créditos | MCP |
|---|---|
| 1 | — |
Parámetros#
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
product_id requerido | path | string | Canonical product ID (prd_...). A GTIN is also accepted here and resolved. |
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. |
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. |
Respuesta#
200 The canonical product with identifiers, attributes and price summary.
| Campo | Tipo | Descripción |
|---|---|---|
data requerido | Product | |
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. |
data.names | object | Name in every available language. |
data.names_meta | object | Provenance of each name, keyed by language. |
data.private_label | boolean | Store brand of one retailer. |
data.relations | object[] | Links to other canonical products. |
data.relations[].kind requerido | string | Valores / values: pack_of, size_of, variant_of, equivalent, replaced_by. |
data.relations[].product_id requerido | string | |
data.relations[].quantity_ratio requerido | number | null | For pack_of and size_of, how many units of product_id this product contains. |
data.identifiers | object | |
data.identifiers.gtin | string[] | |
data.identifiers.mpn | string | null | |
data.attributes | object | |
data.countries | string[] | |
data.first_seen | string (date-time) | |
meta requerido | Meta |
meta trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver Convenciones).
Errores#
Get a product
GET
https://pricto.dev/v1/products/{product_id}Get a product
| Credits | MCP |
|---|---|
| 1 | — |
Parameters#
| Parameter | In | Type | Description |
|---|---|---|---|
product_id required | path | string | Canonical product ID (prd_...). A GTIN is also accepted here and resolved. |
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. |
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. |
Response#
200 The canonical product with identifiers, attributes and price summary.
| Field | Type | Description |
|---|---|---|
data required | Product | |
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. |
data.names | object | Name in every available language. |
data.names_meta | object | Provenance of each name, keyed by language. |
data.private_label | boolean | Store brand of one retailer. |
data.relations | object[] | Links to other canonical products. |
data.relations[].kind required | string | Valores / values: pack_of, size_of, variant_of, equivalent, replaced_by. |
data.relations[].product_id required | string | |
data.relations[].quantity_ratio required | number | null | For pack_of and size_of, how many units of product_id this product contains. |
data.identifiers | object | |
data.identifiers.gtin | string[] | |
data.identifiers.mpn | string | null | |
data.attributes | object | |
data.countries | string[] | |
data.first_seen | string (date-time) | |
meta required | Meta |
meta carries the cost, the source line to quote, the language, the currency and notices (see Conventions).