Vinted

Vinted Search Filters API

The options of one Vinted search filter (size, condition, color or material) with live item counts, optionally for a query and a category: id (what search's size_ids, status_ids, color_ids and material_ids take), localized title, item count, the size group (e.g. "Women > Women's items") and, for conditions, the description. Costs 1 credit per request.

POST/api/v1/vinted/filters

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

countryenum<string>default:fr

The Vinted country site. Category, condition and filter names come back in the site's language. The EU sites share one cross-border listing pool, and every site can show listings from sellers in other countries, priced in the site's currency.

Example: uk

fr — France (vinted.fr), EUR. The default.
be — Belgium (vinted.be), EUR.
lu — Luxembourg (vinted.lu), EUR.
es — Spain (vinted.es), EUR.
nl — Netherlands (vinted.nl), EUR.
lt — Lithuania (vinted.lt), EUR.
de — Germany (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Italy (vinted.it), EUR.
uk — United Kingdom (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — United States (vinted.com), USD.
cz — Czech Republic (vinted.cz), CZK.
sk — Slovakia (vinted.sk), EUR.
pl — Poland (vinted.pl), PLN.
se — Sweden (vinted.se), SEK.
ro — Romania (vinted.ro), RON.
hu — Hungary (vinted.hu), HUF.
dk — Denmark (vinted.dk), DKK.
fi — Finland (vinted.fi), EUR.
hr — Croatia (vinted.hr), EUR.
gr — Greece (vinted.gr), EUR.
ie — Ireland (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Latvia (vinted.lv), EUR.
si — Slovenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

filterenum<string>required

Which filter to list.

Example: size

size — Sizes, grouped per category; pass category_id. Ids go to search's size_ids.
status — Conditions (6 New with tags, 1 New without tags, 2 Very good, 3 Good, 4 Satisfactory). Ids go to status_ids.
color — Colors. Ids go to color_ids.
material — Materials. Ids go to material_ids.

querystring

Count options for this search. Optional.

Example: dress

category_idinteger

Count options within this category, by id from /api/v1/vinted/categories. Sizes are grouped per category, so pass one for size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Women's dress sizes on vinted.co.uk with how many listings each has
res = client.vinted.filters(country="uk", filter="size", query="dress", category_id=1904)["data"]

for o in res["options"]:
    print(o["id"], o["title"], o["item_count"], o.get("group"))

Response

"country": "us",

"filter": "status",

"search_param": "status_ids",

"query": null,

"category_id": null,

"count": 5,

"response_time": 10985

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Women's dress sizes on vinted.co.uk with how many listings each has res = client.vinted.filters(country="uk", filter="size", query="dress", category_id=1904)["data"] for o in res["options"]: print(o["id"], o["title"], o["item_count"], o.get("group"))