Vinted

Vinted Categories API

The Vinted category tree in the country site's language (9 top-level categories, about 3,000 in all): id (what search's category_id takes), title, URL and children; or one category's subtree with its path. Costs 1 credit per request.

POST/api/v1/vinted/categories

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.

parent_idinteger

Return only this category's subtree (1904 is Women, 5 is Men). Omit for the whole tree.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.vinted.categories(country="uk", parent_id=1904)["data"]

def walk(nodes, depth=0):
    for c in nodes:
        print("  " * depth, c["id"], c["title"])
        walk(c["children"], depth + 1)

walk(res["categories"])

Response

"country": "uk",

"count": 273,

"response_time": 2

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.vinted.categories(country="uk", parent_id=1904)["data"] def walk(nodes, depth=0): for c in nodes: print(" " * depth, c["id"], c["title"]) walk(c["children"], depth + 1) walk(res["categories"])