Vinted

Vinted Such-API

Durchsuchen Sie Second-Hand-Angebote auf einer der 27 Vinted-Länderseiten nach Suchbegriff, Kategorie, Marke, Zustand, Größe, Farbe, Material und Preisspanne, sortiert nach Relevanz, Neuheit oder Preis. 96 Artikel pro Seite, Seiten 1 bis 10 (tiefer liefert Vinted nicht). Jeder Artikel enthält ID, Titel, URL, Preis und Währung (die Währung der Länderseite), price_with_discount, service_fee (die Vinted-Gebühr, die der Käufer zusätzlich zahlt, früher Käuferschutzgebühr), total_price, Marke, Größe, Zustand, Anzahl der Favoriten, Kennzeichen für hervorgehobene Angebote, Fotos sowie ID und Gewerbe-Kennzeichen des Verkäufers. Außerdem liefert die Antwort listed_results, total_pages und total_is_capped sowie die Filter, die Vinted tatsächlich angewendet hat, damit ein ignorierter Filter sichtbar wird. Kostet 1 Credit pro Anfrage.

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

Die Vinted-Länderseite. Kategorie-, Zustands- und Filternamen kommen in der Sprache der Seite zurück. Die EU-Seiten teilen sich einen grenzüberschreitenden Angebotspool, und jede Seite kann Angebote von Verkäufern aus anderen Ländern zeigen, umgerechnet in die Währung der Seite.

Example: de

fr — Frankreich (vinted.fr), EUR. Standardwert.
be — Belgien (vinted.be), EUR.
lu — Luxemburg (vinted.lu), EUR.
es — Spanien (vinted.es), EUR.
nl — Niederlande (vinted.nl), EUR.
lt — Litauen (vinted.lt), EUR.
de — Deutschland (vinted.de), EUR.
at — Österreich (vinted.at), EUR.
it — Italien (vinted.it), EUR.
uk — Vereinigtes Königreich (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — USA (vinted.com), USD.
cz — Tschechien (vinted.cz), CZK.
sk — Slowakei (vinted.sk), EUR.
pl — Polen (vinted.pl), PLN.
se — Schweden (vinted.se), SEK.
ro — Rumänien (vinted.ro), RON.
hu — Ungarn (vinted.hu), HUF.
dk — Dänemark (vinted.dk), DKK.
fi — Finnland (vinted.fi), EUR.
hr — Kroatien (vinted.hr), EUR.
gr — Griechenland (vinted.gr), EUR.
ie — Irland (vinted.ie), EUR.
ee — Estland (vinted.ee), EUR.
lv — Lettland (vinted.lv), EUR.
si — Slowenien (vinted.si), EUR.
au — Australien (vinted.com.au), AUD.

querystring

Suchbegriffe, bis zu 200 Zeichen. Optional, wenn category_id oder brand_ids angegeben ist (eine Kategorie oder Marke durchstöbern).

Example: barbour jacket

category_idinteger

Nur diese Kategorie und ihre Unterkategorien, per ID aus /api/v1/vinted/categories (1907 sind Damenmäntel).

Example: 1907

brand_idsinteger[]

Nur diese Marken, per ID aus /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Array oder kommagetrennt, höchstens 20.

Example: [46805]

status_idsinteger[]

Nur diese Zustände: 6 Neu, mit Etikett, 1 Neu, ohne Etikett, 2 Sehr gut, 3 Gut, 4 Zufriedenstellend. Array oder kommagetrennt.

Example: [6, 1]

size_idsinteger[]

Nur diese Größen, per Options-ID aus /api/v1/vinted/filters mit filter size (4 ist Damengröße M / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Nur diese Farben, per Options-ID aus /api/v1/vinted/filters mit filter color (1 ist Schwarz).

Example: [1]

material_idsinteger[]

Nur diese Materialien, per Options-ID aus /api/v1/vinted/filters mit filter material (123 ist Kaschmir).

Example: [123]

price_fromnumber

Mindestpreis des Artikels, in der Währung der Länderseite.

Example: 20

price_tonumber

Höchstpreis des Artikels, in der Währung der Länderseite. Darf nicht unter price_from liegen.

Example: 80

sortstring

relevance (Standard), newest_first, price_low_to_high oder price_high_to_low. Preissortierungen ziehen auch lose passende Artikel nach oben (sehr billige Angebote oder Platzhalterpreise); kombinieren Sie sie daher mit einer Kategorie oder einer Preisspanne.

pageinteger

Ergebnisseite, 1 bis 10. Vinted liefert höchstens 10 Seiten mit je 96 Artikeln. Standard ist 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"], "Artikel, Seite", res["page"], "von", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "mit Vinted-Gebühr", 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"], "Artikel, Seite", res["page"], "von", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "mit Vinted-Gebühr", item["total_price"], item["condition"])