Vinted

API des filtres de recherche Vinted

Les options d'un filtre de recherche Vinted (taille, état, couleur ou matière) avec le nombre d'annonces en direct, éventuellement pour une requête et une catégorie : identifiant (celui qu'attendent size_ids, status_ids, color_ids et material_ids dans la recherche), titre localisé, nombre d'annonces, groupe de tailles (par exemple « Women > Women's items ») et, pour les états, leur description. Coûte 1 crédit par requête.

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

Le site Vinted national. Les noms de catégories, d'états et de filtres sont renvoyés dans la langue du site. Les sites européens partagent un même catalogue transfrontalier, et chaque site peut afficher des annonces de vendeurs d'autres pays, au prix converti dans la devise du site.

Example: fr

fr — France (vinted.fr), EUR. Valeur par défaut.
be — Belgique (vinted.be), EUR.
lu — Luxembourg (vinted.lu), EUR.
es — Espagne (vinted.es), EUR.
nl — Pays-Bas (vinted.nl), EUR.
lt — Lituanie (vinted.lt), EUR.
de — Allemagne (vinted.de), EUR.
at — Autriche (vinted.at), EUR.
it — Italie (vinted.it), EUR.
uk — Royaume-Uni (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — États-Unis (vinted.com), USD.
cz — République tchèque (vinted.cz), CZK.
sk — Slovaquie (vinted.sk), EUR.
pl — Pologne (vinted.pl), PLN.
se — Suède (vinted.se), SEK.
ro — Roumanie (vinted.ro), RON.
hu — Hongrie (vinted.hu), HUF.
dk — Danemark (vinted.dk), DKK.
fi — Finlande (vinted.fi), EUR.
hr — Croatie (vinted.hr), EUR.
gr — Grèce (vinted.gr), EUR.
ie — Irlande (vinted.ie), EUR.
ee — Estonie (vinted.ee), EUR.
lv — Lettonie (vinted.lv), EUR.
si — Slovénie (vinted.si), EUR.
au — Australie (vinted.com.au), AUD.

filterenum<string>required

Le filtre à lister.

Example: size

size — Tailles, groupées par catégorie ; passez category_id. Les identifiants vont dans size_ids de la recherche.
status — États (6 Neuf avec étiquette, 1 Neuf sans étiquette, 2 Très bon état, 3 Bon état, 4 état satisfaisant). Les identifiants vont dans status_ids.
color — Couleurs. Les identifiants vont dans color_ids.
material — Matières. Les identifiants vont dans material_ids.

querystring

Compter les options pour cette recherche. Facultatif.

Example: dress

category_idinteger

Compter les options dans cette catégorie, par identifiant issu de /api/v1/vinted/categories. Les tailles sont groupées par catégorie : passez-en une pour size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Tailles de robes pour femmes sur vinted.co.uk, avec le nombre d'annonces de chacune
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") # Tailles de robes pour femmes sur vinted.co.uk, avec le nombre d'annonces de chacune 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"))