Vinted

Vinted Search Filters API

De opties van één Vinted-zoekfilter (maat, staat, kleur of materiaal) met actuele aantallen artikelen, optioneel voor een zoekopdracht en een categorie: ID (wat size_ids, status_ids, color_ids en material_ids van search verwachten), gelokaliseerde titel, aantal artikelen, de maatgroep (bijv. "Women > Women's items") en, bij staten, de omschrijving. Kost 1 credit per verzoek.

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

De Vinted-site van het land. Namen van categorieën, staten en filters komen terug in de taal van de site. De EU-sites delen één grensoverschrijdende pool van advertenties, en elke site kan advertenties van verkopers uit andere landen tonen, omgerekend naar de valuta van de site.

Example: nl

fr — Frankrijk (vinted.fr), EUR. De standaard.
be — België (vinted.be), EUR.
lu — Luxemburg (vinted.lu), EUR.
es — Spanje (vinted.es), EUR.
nl — Nederland (vinted.nl), EUR.
lt — Litouwen (vinted.lt), EUR.
de — Duitsland (vinted.de), EUR.
at — Oostenrijk (vinted.at), EUR.
it — Italië (vinted.it), EUR.
uk — Verenigd Koninkrijk (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — Verenigde Staten (vinted.com), USD.
cz — Tsjechië (vinted.cz), CZK.
sk — Slowakije (vinted.sk), EUR.
pl — Polen (vinted.pl), PLN.
se — Zweden (vinted.se), SEK.
ro — Roemenië (vinted.ro), RON.
hu — Hongarije (vinted.hu), HUF.
dk — Denemarken (vinted.dk), DKK.
fi — Finland (vinted.fi), EUR.
hr — Kroatië (vinted.hr), EUR.
gr — Griekenland (vinted.gr), EUR.
ie — Ierland (vinted.ie), EUR.
ee — Estland (vinted.ee), EUR.
lv — Letland (vinted.lv), EUR.
si — Slovenië (vinted.si), EUR.
au — Australië (vinted.com.au), AUD.

filterenum<string>required

Welk filter je wilt ophalen.

Example: size

size — Maten, gegroepeerd per categorie; geef category_id mee. De ID's gaan naar size_ids van search.
status — Staten (6 New with tags, 1 New without tags, 2 Very good, 3 Good, 4 Satisfactory; op vinted.nl onder meer Nieuw met prijskaartje en Heel goed). De ID's gaan naar status_ids.
color — Kleuren. De ID's gaan naar color_ids.
material — Materialen. De ID's gaan naar material_ids.

querystring

Tel de opties voor deze zoekopdracht. Optioneel.

Example: jurk

category_idinteger

Tel de opties binnen deze categorie, op ID uit /api/v1/vinted/categories. Maten zijn per categorie gegroepeerd, dus geef er een mee voor size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Jurkmaten voor dames op vinted.co.uk, met het aantal advertenties per maat
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") # Jurkmaten voor dames op vinted.co.uk, met het aantal advertenties per maat 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"))