Vinted

Vinted Search API

Doorzoek tweedehands advertenties op elk van de 27 Vinted-sites op trefwoorden, categorie, merk, staat, maat, kleur, materiaal en prijsbereik, gesorteerd op relevantie, nieuwste of prijs. 96 artikelen per pagina, pagina 1-10 (dieper gaat Vinted niet). Elk artikel heeft een ID, titel, URL, prijs en valuta (die van de site), price_with_discount, service_fee (de Vinted-vergoeding die de koper erbovenop betaalt, voorheen de Buyer Protection fee), total_price, merk, maat, staat, aantal favorieten, gepromoot-vlag, foto's en de ID en zakelijk-vlag van de verkoper. Geeft ook listed_results, total_pages en total_is_capped terug, plus de filters die Vinted echt heeft toegepast, zodat je ziet als er een genegeerd is. Kost 1 credit per verzoek.

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

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.

querystring

Zoekwoorden, maximaal 200 tekens. Optioneel als category_id of brand_ids is meegegeven (een categorie of merk doorbladeren).

Example: jurk

category_idinteger

Alleen deze categorie en de subcategorieën ervan, op ID uit /api/v1/vinted/categories (1907 is Dames > Kleding > Bovenkleding > Jassen).

Example: 1907

brand_idsinteger[]

Alleen deze merken, op ID uit /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Array of kommagescheiden, maximaal 20.

Example: [46805]

status_idsinteger[]

Alleen deze staten: 6 Nieuw met prijskaartje, 1 Nieuw zonder prijskaartje, 2 Heel goed, 3 Goed, 4 Satisfactory (Engelse naam; /api/v1/vinted/filters met filter status geeft de labels van elke site). Array of kommagescheiden.

Example: [6, 1]

size_idsinteger[]

Alleen deze maten, op optie-ID uit /api/v1/vinted/filters met filter size (4 is dames M / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Alleen deze kleuren, op optie-ID uit /api/v1/vinted/filters met filter color (1 is zwart).

Example: [1]

material_idsinteger[]

Alleen deze materialen, op optie-ID uit /api/v1/vinted/filters met filter material (123 is kasjmier).

Example: [123]

price_fromnumber

Minimale artikelprijs, in de valuta van de site.

Example: 20

price_tonumber

Maximale artikelprijs, in de valuta van de site. Mag niet lager zijn dan price_from.

Example: 80

sortstring

relevance (standaard), newest_first, price_low_to_high of price_high_to_low. Sorteren op prijs haalt ook losjes passende artikelen naar boven (heel goedkope of met een plaatshouderprijs), dus combineer het met een categorie of prijsbereik.

pageinteger

Resultatenpagina, 1-10. Vinted toont maximaal 10 pagina's van 96. Standaard 1.

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"], "items, page", res["page"], "of", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "with the Vinted fee", 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"], "items, page", res["page"], "of", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "with the Vinted fee", item["total_price"], item["condition"])