Vinted

Vinted API für Suchfilter

Die Optionen eines Vinted-Suchfilters (Größe, Zustand, Farbe oder Material) mit aktueller Trefferzahl, optional für einen Suchbegriff und eine Kategorie: ID (die size_ids, status_ids, color_ids und material_ids in der Suche erwarten), lokalisierter Titel, Anzahl der Angebote, die Größengruppe (etwa „Women > Women's items“) und bei Zuständen deren Beschreibung. Kostet 1 Credit pro Anfrage.

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

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.

filterenum<string>required

Welcher Filter aufgelistet wird.

Example: size

size — Größen, gruppiert pro Kategorie; category_id angeben. Die IDs gehen an size_ids der Suche.
status — Zustände (6 Neu, mit Etikett, 1 Neu, ohne Etikett, 2 Sehr gut, 3 Gut, 4 Zufriedenstellend). Die IDs gehen an status_ids.
color — Farben. Die IDs gehen an color_ids.
material — Materialien. Die IDs gehen an material_ids.

querystring

Optionen für diese Suche zählen. Optional.

Example: dress

category_idinteger

Optionen innerhalb dieser Kategorie zählen, per ID aus /api/v1/vinted/categories. Größen sind pro Kategorie gruppiert; für size also eine angeben.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Größen für Damenkleider auf vinted.co.uk mit der Anzahl der Angebote je Größe
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") # Größen für Damenkleider auf vinted.co.uk mit der Anzahl der Angebote je Größe 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"))