<!-- https://pricto.dev/docs/api/list-retailers · Spanish version: https://pricto.dev/docs/api/list-retailers.md -->

# List retailers

`GET https://pricto.dev/v1/retailers`

List retailers

| Credits | MCP |
|---|---|
| 0 | — |

## Parameters

| Parameter | In | Type | Description |
|---|---|---|---|
| `country` | query | `string` | ISO 3166-1 alpha-2 country code. Defaults to all covered countries. |
| `segment` | query | `Segment` |  |
| `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`. |

## Response

`200` Retailers with their coverage.

| Field | Type | Description |
|---|---|---|
| `data` **required** | `Retailer[]` |  |
| `data[].id` **required** | `string` |  |
| `data[].name` **required** | `string` |  |
| `data[].country` **required** | `string` |  |
| `data[].group` | `string \| null` |  |
| `data[].segments` **required** | `Segment[]` |  |
| `data[].website` **required** | `string (uri)` |  |
| `data[].timezone` | `string` |  |
| `data[].location_pricing` | `boolean` | Whether prices vary by store or area. |
| `data[].coverage` **required** | `object` |  |
| `data[].coverage.offers` **required** | `integer` |  |
| `data[].coverage.matched_pct` **required** | `number` |  |
| `data[].coverage.frequency` **required** | `string` | Valores / values: `hourly`, `daily`, `weekly`. |
| `data[].coverage.history_since` **required** | `string (date) \| null` |  |
| `data[].coverage.last_observed` **required** | `string (date-time) \| null` |  |
| `meta` **required** | `Meta` |  |

`meta` carries the cost, the source line to quote, the language, the currency and notices (see [Conventions](/docs/convenciones)).

## Errors

## Example

```bash
curl "https://pricto.dev/v1/retailers?segment=pharmacy" \
  -H "Authorization: Bearer sk_test_sandbox"
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/retailers",
    params={"segment": "pharmacy"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

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

```json
{
  "data": [
    {
      "id": "cl-cruzverde",
      "name": "Cruz Verde",
      "country": "CL",
      "group": "Socofar",
      "segments": [
        "pharmacy"
      ],
      "website": "https://www.cruzverde.cl",
      "timezone": "America/Santiago",
      "location_pricing": false,
      "coverage": {
        "offers": 11,
        "matched_pct": 100,
        "frequency": "daily",
        "history_since": "2026-06-26",
        "last_observed": "2026-10-23T11:00:00Z"
      }
    },
    {
      "id": "cl-ahumada",
      "name": "Farmacias Ahumada",
      "country": "CL",
      "group": "Fasa",
      "segments": [
        "pharmacy"
      ],
      "website": "https://www.farmaciasahumada.cl",
      "timezone": "America/Santiago",
      "location_pricing": false,
      "coverage": {
        "offers": 13,
        "matched_pct": 100,
        "frequency": "daily",
        "history_since": "2026-06-26",
        "last_observed": "2026-10-23T11:00:00Z"
      }
    },
    "… 2 más / more"
  ],
  "meta": {
    "request_id": "req_aab1dd5967c143c69b52",
    "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"
    ]
  }
}
```