Vinted

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 Watch and analytics requests. If market is omitted, Nephia defaults to fr (same default as Vinted). A market outside this allowlist returns 400 with code VALIDATION.

Coverage

A Watch on Vinted polls search criteria and keeps every listing that matches. The criteria are flat — not a nested filters object:

Criterion	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
`per_page`	number	Results per tick (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 criteria accept either repeated values or a comma-separated string.

What an event carries

Matches are delivered as listing.* events with the full listing. webhook_url is optional — without it the Watch still records every match, readable through GET /v1/vinted/watches/{id}/events. See Watches and Webhooks.

Price history & market stats

Nephia records what listings cost as it sees them, and exposes two reads over that history — our own observations, not a call to Vinted. GET /v1/vinted/items/{id}/price-history returns every point observed for one item, oldest first:

{
  "itemId": "1234567890",
  "market": "fr",
  "history": [
    {
      "observedAt": "2026-08-01T09:12:44.000Z",
      "price": 45,
      "currency": "EUR",
      "status": "Très bon état",
      "favouriteCount": 12,
      "viewCount": 340
    }
  ]
}

Parameter	Type	Description
`market`	string	Market code, default `fr`
`from`	ISO-8601	Lower bound on `observedAt`
`to`	ISO-8601	Upper bound on `observedAt`
`limit`	number	Points to return, default `200`, max `500`

GET /v1/vinted/market/stats returns per-day percentiles over a market, newest first:

{
  "market": "fr",
  "from": "2026-07-19T00:00:00.000Z",
  "to": "2026-08-18T00:00:00.000Z",
  "filters": { "brand_id": 53, "catalog_id": null, "size_id": null, "status": null, "currency": null },
  "stats": [
    { "date": "2026-08-18", "currency": "EUR", "count": 412, "p25": 18, "median": 29, "p75": 45, "soldRate": null }
  ]
}

Parameter	Type	Description
`market`	string	Market code, default `fr`
`from`	ISO-8601	Start of the range, default 30 days ago
`to`	ISO-8601	End of the range, default now
`brand_id`	number	Brand filter — the numeric id Vinted uses, as it appears on observed listings
`catalog_id`	number	Catalog filter
`size_id`	number	Size filter
`status`	string	Vinted condition label as observed, e.g. `Très bon état`
`currency`	string	Currency code, e.g. `EUR`

A range may not exceed 365 days. Days are grouped by currency as well as by date, so percentiles are never averaged across two currencies.

These endpoints describe what Nephia has observed, not all of Vinted. A point exists only for an item that appeared in a search Nephia ran — a Vinted Watch tick. Coverage grows with usage, and a brand nobody watches has no history. Treat the numbers as a sample, not a census.

A point is recorded when an item’s price or status changed, or once every 24 hours while neither did — so consecutive points are movements, not poll ticks. Observations are kept for 365 days. soldRate is always null: Vinted does not confirm sales, and Nephia does not yet infer them.

Guides

Sources

Integrations

API Reference

Enabled markets

Coverage

What an event carries

Price history & market stats

​Enabled markets

​Coverage

​What an event carries

​Price history & market stats

Enabled markets

Coverage

What an event carries

Price history & market stats