Vinted

API de recherche Vinted

Recherchez des annonces de seconde main sur l'un des 27 sites Vinted nationaux par mots-clés, catégorie, marque, état, taille, couleur, matière et fourchette de prix, triées par pertinence, nouveauté ou prix. 96 articles par page, pages 1 à 10 (Vinted ne sert pas au-delà). Chaque article contient son identifiant, son titre, son URL, son prix et sa devise (celle du site interrogé), price_with_discount, service_fee (les frais Vinted payés en plus par l'acheteur, anciennement frais de Protection acheteurs), total_price, la marque, la taille, l'état, le nombre de favoris, l'indicateur d'annonce promue, les photos ainsi que l'identifiant et le statut pro du vendeur. La réponse renvoie aussi listed_results, total_pages et total_is_capped, ainsi que les filtres réellement appliqués par Vinted, pour qu'un filtre ignoré soit visible. Coûte 1 crédit par requête.

POST/api/v1/vinted/search

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.

querystring

Mots-clés de recherche, jusqu'à 200 caractères. Facultatif si category_id ou brand_ids est fourni (parcours d'une catégorie ou d'une marque).

Example: barbour jacket

category_idinteger

Uniquement cette catégorie et ses sous-catégories, par identifiant issu de /api/v1/vinted/categories (1907 correspond à Femmes > Vêtements > Manteaux et vestes > Manteaux).

Example: 1907

brand_idsinteger[]

Uniquement ces marques, par identifiant issu de /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Tableau ou liste séparée par des virgules, 20 au maximum.

Example: [46805]

status_idsinteger[]

Uniquement ces états : 6 Neuf avec étiquette, 1 Neuf sans étiquette, 2 Très bon état, 3 Bon état, 4 état satisfaisant (le plus usé). Tableau ou liste séparée par des virgules.

Example: [6, 1]

size_idsinteger[]

Uniquement ces tailles, par identifiant d'option issu de /api/v1/vinted/filters avec filter size (4 correspond à la taille femme M / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Uniquement ces couleurs, par identifiant d'option issu de /api/v1/vinted/filters avec filter color (1 correspond au noir).

Example: [1]

material_idsinteger[]

Uniquement ces matières, par identifiant d'option issu de /api/v1/vinted/filters avec filter material (123 correspond au cachemire).

Example: [123]

price_fromnumber

Prix minimum de l'article, dans la devise du site.

Example: 20

price_tonumber

Prix maximum de l'article, dans la devise du site. Ne doit pas être inférieur à price_from.

Example: 80

sortstring

relevance (par défaut), newest_first, price_low_to_high ou price_high_to_low. Les tris par prix font aussi remonter des articles qui ne correspondent que vaguement (annonces très bon marché ou à prix symbolique) : associez-les à une catégorie ou à une fourchette de prix.

pageinteger

Page de résultats, de 1 à 10. Vinted sert au maximum 10 pages de 96. 1 par défaut.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.vinted.search(country="uk", query="barbour jacket", sort="newest_first")["data"]

print(res["count"], "articles, page", res["page"], "sur", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "frais Vinted compris", item["total_price"], item["condition"])

Response

"country": "uk",

"currency": "GBP",

"query": "barbour jacket",

"page": 1,

"per_page": 96,

"count": 96,

"listed_results": 960,

"total_is_capped": true,

"total_pages": 10,

"has_more": true,

"response_time": 6335

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.vinted.search(country="uk", query="barbour jacket", sort="newest_first")["data"] print(res["count"], "articles, page", res["page"], "sur", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "frais Vinted compris", item["total_price"], item["condition"])