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	Required
query	optional
search_text	optional
filters	optional
brand_ids	optional
size_ids	optional
status_ids	optional
catalog_ids	optional
color_ids	optional
material_ids	optional
price_from	optional
price_to	optional
currency	optional
order	optional
per_page	optional
page	optional
tld	optional

Try in playground →

post/vinted/v1/item_detail2 credits

full item via parse (title/price/photos/desc/color/condition/category)

Parameter	Required
id	optional
item_id	optional
url	optional
path	optional
tld	optional

Try in playground →

post/vinted/v1/seller1 credit

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

Parameter	Required
id	optional
user_id	optional
seller_id	optional
tld	optional

Try in playground →

post/vinted/v1/seller_items1 credit

a seller's wardrobe items

Parameter	Required
id	optional
user_id	optional
seller_id	optional
page	optional
per_page	optional
tld	optional

Try in playground →

post/vinted/v1/seller_feedback1 credit

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

Parameter	Required
id	optional
user_id	optional
seller_id	optional
page	optional
per_page	optional
tld	optional

Try in playground →

post/vinted/v1/brand_search1 credit

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

Parameter	Required
query	optional
search_text	optional
page	optional
per_page	optional
tld	optional

Try in playground →

post/vinted/v1/similar1 credit

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

Parameter	Required
id	optional
item_id	optional
content_source	optional
tld	optional

Try in playground →

post/vinted/v1/catalog_filters1 credit

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

Parameter	Required
query	optional
search_text	optional
catalog_ids	optional
tld	optional

Try in playground →

post/vinted/v1/categoriesfree

full category tree (id/title/code/url/children) from

Parameter	Required
tld	optional

Try in playground →

post/vinted/v1/colorsfree

color enum (id/title/hex/code)

Parameter	Required
tld	optional

Try in playground →

post/vinted/v1/conditionsfree

item-condition enum (status id/title)

Parameter	Required
tld	optional

Try in playground →

post/vinted/v1/countriesfree

country enum (id/iso/currency)

Parameter	Required
tld	optional

Try in playground →

post/vinted/v1/sizesfree

size groups + size ids

Parameter	Required
tld	optional

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
}