> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Vinted

> Pull listings, sellers, and reference data from Vinted.

Vinted endpoints live under `/v1/vinted/*`. See the [API Reference](/api-reference/overview) for the full endpoint list.

## Enabled markets

Nephia enables these Vinted markets:

| Code | Domain        |
| ---- | ------------- |
| `fr` | vinted.fr     |
| `de` | vinted.de     |
| `uk` | vinted.co.uk  |
| `it` | vinted.it     |
| `es` | vinted.es     |
| `pl` | vinted.pl     |
| `nl` | vinted.nl     |
| `be` | vinted.be     |
| `cz` | vinted.cz     |
| `lt` | vinted.lt     |
| `pt` | vinted.pt     |
| `at` | vinted.at     |
| `lu` | vinted.lu     |
| `sk` | vinted.sk     |
| `dk` | vinted.dk     |
| `fi` | vinted.fi     |
| `se` | vinted.se     |
| `ro` | vinted.ro     |
| `hu` | vinted.hu     |
| `hr` | vinted.hr     |
| `gr` | vinted.gr     |
| `us` | vinted.com    |
| `au` | vinted.com.au |
| `lv` | vinted.lv     |
| `ee` | vinted.ee     |

Pass `market` on Vinted pull and watch requests. If `market` is omitted, Nephia defaults to **`fr`** (same default as Vinted).

A market outside this allowlist returns `400` with code `VALIDATION`.

## Search filters

`GET /v1/vinted/search` and watch `criteria` use **flat** query parameters — not a nested `filters` object:

| Parameter     | Type                      | Description                                                                     |
| ------------- | ------------------------- | ------------------------------------------------------------------------------- |
| `market`      | string                    | Market code (optional, default `fr`). Must be one of the enabled markets above. |
| `query`       | string                    | Text search                                                                     |
| `price_min`   | number                    | Minimum price                                                                   |
| `price_max`   | number                    | Maximum price                                                                   |
| `sort`        | string                    | Sort order                                                                      |
| `page`        | number                    | Page number (default 1)                                                         |
| `per_page`    | number                    | Results per page (max 96)                                                       |
| `brand_ids`   | number or comma-separated | Brand filter                                                                    |
| `size_ids`    | number or comma-separated | Size filter                                                                     |
| `catalog_ids` | number or comma-separated | Catalog filter                                                                  |
| `color_ids`   | number or comma-separated | Color filter                                                                    |
| `status_ids`  | number or comma-separated | Status filter                                                                   |

Array parameters accept either repeated values or a comma-separated string.

## Reference data

`GET /v1/vinted/reference/{type}` returns Vinted filter metadata. Supported `type` values: `brands`, `colors`, `statuses`, `sizes`, `markets`.

<Note>
  `GET /v1/vinted/reference/markets` returns Vinted's full country catalogue. That list is **not** the same as Nephia's enabled-market allowlist — only markets documented above are callable.
</Note>

Credit costs per type are in [Credits](/credits#vinted-pull-rates).

## Watches

Vinted watches poll search criteria and deliver `listing.*` webhook events. See [Watches](/watches) and [Webhooks](/webhooks).