Listar locales físicos y puntos de retiro

GEThttps://pricto.dev/v1/stores

Used to resolve location for retailers whose prices vary by store or area.

Créditos	MCP
0	—

Parámetros#

Parámetro	En	Tipo	Descripción
`retailer`	query	`string`	One or more retailer IDs, comma separated (e.g. `cl-jumbo,cl-unimarc`).
`country`	query	`string`	ISO 3166-1 alpha-2 country code. Defaults to all covered countries.
`admin_area`	query	`string`	Administrative area code, for Chile the comuna CUT code (e.g. `13114`).
`limit`	query	`integer`	Default: `50`.
`cursor`	query	`string`	Opaque cursor from `pagination.next_cursor`.

Respuesta#

200 Stores.

Campo	Tipo	Descripción
`data` requerido	`Store[]`
`data[].id` requerido	`string`
`data[].retailer_id` requerido	`string`
`data[].name` requerido	`string`
`data[].address`	`string \| null`
`data[].admin_area` requerido	`object`
`data[].admin_area.country` requerido	`string`
`data[].admin_area.code` requerido	`string`	For Chile, comuna CUT code.
`data[].admin_area.name` requerido	`string`
`data[].admin_area.region`	`string \| null`
`data[].lat`	`number \| null`
`data[].lng`	`number \| null`
`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 physical stores and pickup points

GEThttps://pricto.dev/v1/stores

Used to resolve location for retailers whose prices vary by store or area.

Credits	MCP
0	—

Parameters#

Parameter	In	Type	Description
`retailer`	query	`string`	One or more retailer IDs, comma separated (e.g. `cl-jumbo,cl-unimarc`).
`country`	query	`string`	ISO 3166-1 alpha-2 country code. Defaults to all covered countries.
`admin_area`	query	`string`	Administrative area code, for Chile the comuna CUT code (e.g. `13114`).
`limit`	query	`integer`	Default: `50`.
`cursor`	query	`string`	Opaque cursor from `pagination.next_cursor`.

Response#

200 Stores.

Field	Type	Description
`data` required	`Store[]`
`data[].id` required	`string`
`data[].retailer_id` required	`string`
`data[].name` required	`string`
`data[].address`	`string \| null`
`data[].admin_area` required	`object`
`data[].admin_area.country` required	`string`
`data[].admin_area.code` required	`string`	For Chile, comuna CUT code.
`data[].admin_area.name` required	`string`
`data[].admin_area.region`	`string \| null`
`data[].lat`	`number \| null`
`data[].lng`	`number \| null`
`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).

Errors#

Ejemplo#

curl "https://pricto.dev/v1/stores?retailer=cl-jumbo" \
  -H "Authorization: Bearer sk_test_sandbox"

import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/stores",
    params={"retailer": "cl-jumbo"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch(`https://pricto.dev/v1/stores?${new URLSearchParams({"retailer":"cl-jumbo"})}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());

200 · respuesta real de la sandbox

{
  "data": [
    {
      "id": "str_jumbo1",
      "retailer_id": "cl-jumbo",
      "name": "Jumbo Santiago",
      "address": null,
      "admin_area": {
        "country": "CL",
        "code": "13101",
        "name": "Santiago",
        "region": "Metropolitana"
      },
      "lat": null,
      "lng": null
    },
    {
      "id": "str_jumbo2",
      "retailer_id": "cl-jumbo",
      "name": "Jumbo Providencia",
      "address": null,
      "admin_area": {
        "country": "CL",
        "code": "13123",
        "name": "Providencia",
        "region": "Metropolitana"
      },
      "lat": null,
      "lng": null
    },
    "… 1 más / more"
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_0c3034d1bbb046d1a779",
    "attribution": {
      "text": "Fuente: Pricto · 23-10-2026 08:00 CLST",
      "source": "Pricto",
      "as_of": "2026-10-23T11:00:00Z",
      "resource_id": null,
      "url": null,
      "capture_method": null,
      "source_url": null
    },
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}

Example#

curl "https://pricto.dev/v1/stores?retailer=cl-jumbo" \
  -H "Authorization: Bearer sk_test_sandbox"

import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/stores",
    params={"retailer": "cl-jumbo"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch(`https://pricto.dev/v1/stores?${new URLSearchParams({"retailer":"cl-jumbo"})}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());

200 · real sandbox response

{
  "data": [
    {
      "id": "str_jumbo1",
      "retailer_id": "cl-jumbo",
      "name": "Jumbo Santiago",
      "address": null,
      "admin_area": {
        "country": "CL",
        "code": "13101",
        "name": "Santiago",
        "region": "Metropolitana"
      },
      "lat": null,
      "lng": null
    },
    {
      "id": "str_jumbo2",
      "retailer_id": "cl-jumbo",
      "name": "Jumbo Providencia",
      "address": null,
      "admin_area": {
        "country": "CL",
        "code": "13123",
        "name": "Providencia",
        "region": "Metropolitana"
      },
      "lat": null,
      "lng": null
    },
    "… 1 más / more"
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_0c3034d1bbb046d1a779",
    "attribution": {
      "text": "Fuente: Pricto · 23-10-2026 08:00 CLST",
      "source": "Pricto",
      "as_of": "2026-10-23T11:00:00Z",
      "resource_id": null,
      "url": null,
      "capture_method": null,
      "source_url": null
    },
    "credits_charged": 0,
    "credits_deduplicated": 0,
    "credits_remaining": 14988,
    "period_resets_at": "2026-11-01T00:00:00.000Z",
    "usage": {
      "credits_charged": 0,
      "credits_deduplicated": 0,
      "truncated": false,
      "truncated_reason": null,
      "dry_run": false,
      "units": {}
    },
    "lang": "es",
    "currency": "local",
    "data_as_of": "2026-10-23T11:00:00Z",
    "warnings": [
      "synthetic_data: datos sintéticos de ejemplo / synthetic sample data"
    ]
  }
}