Vinted

Vinted Search Filters API

Opcje jednego filtra wyszukiwania Vinted (rozmiar, stan, kolor lub materiał) z bieżącą liczbą przedmiotów, opcjonalnie dla zapytania i kategorii: ID (wartość dla size_ids, status_ids, color_ids i material_ids w search), zlokalizowana nazwa, liczba przedmiotów, grupa rozmiarów (np. "Women > Women's items") oraz, dla stanów, opis. Koszt: 1 kredyt za zapytanie.

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

Krajowa strona Vinted. Nazwy kategorii, stanów i filtrów wracają w języku danej strony. Strony z UE mają jedną wspólną, transgraniczną pulę ogłoszeń, a każda strona może pokazywać ogłoszenia sprzedawców z innych krajów, z ceną przeliczoną na walutę strony.

Example: pl

fr — Francja (vinted.fr), EUR. Wartość domyślna.
be — Belgia (vinted.be), EUR.
lu — Luksemburg (vinted.lu), EUR.
es — Hiszpania (vinted.es), EUR.
nl — Holandia (vinted.nl), EUR.
lt — Litwa (vinted.lt), EUR.
de — Niemcy (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Włochy (vinted.it), EUR.
uk — Wielka Brytania (vinted.co.uk), GBP.
pt — Portugalia (vinted.pt), EUR.
us — Stany Zjednoczone (vinted.com), USD.
cz — Czechy (vinted.cz), CZK.
sk — Słowacja (vinted.sk), EUR.
pl — Polska (vinted.pl), PLN.
se — Szwecja (vinted.se), SEK.
ro — Rumunia (vinted.ro), RON.
hu — Węgry (vinted.hu), HUF.
dk — Dania (vinted.dk), DKK.
fi — Finlandia (vinted.fi), EUR.
hr — Chorwacja (vinted.hr), EUR.
gr — Grecja (vinted.gr), EUR.
ie — Irlandia (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Łotwa (vinted.lv), EUR.
si — Słowenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

filterenum<string>required

Który filtr pobrać.

Example: size

size — Rozmiary, pogrupowane według kategorii; podaj category_id. ID trafiają do size_ids w search.
status — Stany (6 New with tags, 1 New without tags, 2 Very good, 3 Good, 4 Satisfactory; na vinted.pl m.in. Nowy z metką i Bardzo dobry). ID trafiają do status_ids.
color — Kolory. ID trafiają do color_ids.
material — Materiały. ID trafiają do material_ids.

querystring

Policz opcje dla tego wyszukiwania. Opcjonalne.

Example: sukienka

category_idinteger

Policz opcje w tej kategorii, po ID z /api/v1/vinted/categories. Rozmiary są pogrupowane według kategorii, więc dla size podaj kategorię.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Rozmiary damskich sukienek na vinted.co.uk z liczbą ogłoszeń dla każdego
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") # Rozmiary damskich sukienek na vinted.co.uk z liczbą ogłoszeń dla każdego 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"))