docs / vinted

Vinted

Second-hand fashion listings and prices.

base /vinted/v113 endpoints

post/vinted/v1/catalog_search2 credits

keyword + filter search (brand/size/condition/category/color/material/price)

Parameter		Allowed / range	Description
query	optional	—	What to search for (item keywords). Give query and/or at least one *_ids/price filter.
order = newest_first	optional	newest_first · relevance · price_low_to_high · price_high_to_low	Result ordering (the 4 Vinted UI orders, all live-verified; unknown values are ignored upstream).
brand_ids	optional	—	Only these brands — numeric ids from the brand_search action (e.g. brand_search 'nike' → id).
catalog_ids	optional	—	Only these categories — ids from the categories action.
size_ids	optional	—	Only these sizes — ids from the sizes action.
status_ids	optional	—	Only these conditions — ids from the conditions action.
color_ids	optional	—	Only these colors — ids from the colors action.
material_ids	optional	—	Only these materials — ids from the catalog_filters action.
price_from	optional	0–	Only items at or above this price.
price_to	optional	0–	Only items at or below this price.
currency	optional	—	Currency code for price_from/price_to (defaults to the site's own currency).
filters	optional	—	Raw Vinted filter object (advanced — overrides all the individual *_ids/price params).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).
page = 1	optional	1–	Page number (1, 2, 3… — Vinted serves at most ~960 results per filter combination; narrow filters to go deeper).
per_page = 20	optional	1–96	Results per page (1–96; Vinted caps larger values at 96).

Try in playground →

post/vinted/v1/item_detail2 credits

Full Vinted item detail — title, price, photos, description, color, condition and category.

Parameter		Allowed / range	Description
id	optional	—	Vinted item ID — the digits in the item URL (…/items/<id>-slug). Provide id OR url (one of the two is required).
url	optional	—	Full item URL — alternative to id.
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/seller1 credit

seller profile (login/rating/item_count/feedback breakdown) — PII redactable

Parameter		Allowed / range	Description
id	required	—	Vinted user ID — take it from catalog_search items[].seller.id or from a member URL (vinted.fr/member/<id>).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/seller_items1 credit

a seller's wardrobe items

Parameter		Allowed / range	Description
id	required	—	Vinted user ID — take it from catalog_search items[].seller.id or from a member URL (vinted.fr/member/<id>).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).
page = 1	optional	1–	Page number (1, 2, 3… — Vinted serves at most ~960 results per filter combination; narrow filters to go deeper).
per_page = 20	optional	1–96	Results per page (1–96; Vinted caps larger values at 96).

Try in playground →

post/vinted/v1/seller_feedback1 credit

feedback left for a seller (text/rating/reviewer)

Parameter		Allowed / range	Description
id	required	—	Vinted user ID — take it from catalog_search items[].seller.id or from a member URL (vinted.fr/member/<id>).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).
page = 1	optional	1–	Page number (1, 2, 3… — Vinted serves at most ~960 results per filter combination; narrow filters to go deeper).
per_page = 20	optional	1–96	Results per page (1–96; Vinted caps larger values at 96).

Try in playground →

post/vinted/v1/brand_search1 credit

resolve a brand name -> brand_id (+ item/favourite counts)

Parameter		Allowed / range	Description
query	optional	—	Brand name (or part of it) to look up (empty = the default brand list).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).
page = 1	optional	1–	Page number (1, 2, 3… — Vinted serves at most ~960 results per filter combination; narrow filters to go deeper).
per_page = 20	optional	1–96	Results per page (1–96; Vinted caps larger values at 96).

Try in playground →

post/vinted/v1/similar1 credit

items similar to a given item (items/{id}/more)

Parameter		Allowed / range	Description
id	required	—	Vinted item ID to find lookalikes for.
content_source = similar_items	optional	—	Upstream recommendation source (advanced) — leave at the default.
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/catalog_filters1 credit

dynamic facets (size/brand/status/color/price/material + option ids) for a query/category

Parameter		Allowed / range	Description
query	optional	—	Keyword whose facets you want (optional — empty = global).
catalog_ids	optional	—	Narrow facets to these category ids (from the categories action).
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/categoriesfree

Full Vinted category tree — id, title, code, URL and child categories for the selected country site.

Parameter		Allowed / range	Description
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/colorsfree

color enum (id/title/hex/code)

Parameter		Allowed / range	Description
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/conditionsfree

item-condition enum (status id/title)

Parameter		Allowed / range	Description
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/countriesfree

country enum (id/iso/currency)

Parameter		Allowed / range	Description
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

post/vinted/v1/sizesfree

size groups + size ids

Parameter		Allowed / range	Description
tld = fr	optional	fr · de · es · it · nl · be · lt · lu · at · pt · sk · fi · co.uk · pl · cz · se · ro · hu · dk · com	Which Vinted site to query (sets currency and local listings).

Try in playground →

Example request · catalog_search

curl -X POST https://api.reefapi.com/vinted/v1/catalog_search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nike","tld":"fr","per_page":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}