Vinted

API dei filtri di ricerca Vinted

Le opzioni di un filtro di ricerca Vinted (taglia, condizioni, colore o materiale) con il numero di articoli in tempo reale, facoltativamente per una query e una categoria: id (quello che accettano size_ids, status_ids, color_ids e material_ids nella ricerca), titolo nella lingua del sito, numero di articoli, il gruppo di taglie (ad es. "Women > Women's items") e, per le condizioni, la descrizione. Costa 1 credito per richiesta.

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

Il sito Vinted del paese. Nomi di categorie, condizioni e filtri arrivano nella lingua del sito. I siti UE condividono un unico bacino di annunci transfrontaliero, e ogni sito può mostrare annunci di venditori di altri paesi, con il prezzo convertito nella valuta del sito.

Example: it

fr — Francia (vinted.fr), EUR. Il valore predefinito.
be — Belgio (vinted.be), EUR.
lu — Lussemburgo (vinted.lu), EUR.
es — Spagna (vinted.es), EUR.
nl — Paesi Bassi (vinted.nl), EUR.
lt — Lituania (vinted.lt), EUR.
de — Germania (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Italia (vinted.it), EUR.
uk — Regno Unito (vinted.co.uk), GBP.
pt — Portogallo (vinted.pt), EUR.
us — Stati Uniti (vinted.com), USD.
cz — Repubblica Ceca (vinted.cz), CZK.
sk — Slovacchia (vinted.sk), EUR.
pl — Polonia (vinted.pl), PLN.
se — Svezia (vinted.se), SEK.
ro — Romania (vinted.ro), RON.
hu — Ungheria (vinted.hu), HUF.
dk — Danimarca (vinted.dk), DKK.
fi — Finlandia (vinted.fi), EUR.
hr — Croazia (vinted.hr), EUR.
gr — Grecia (vinted.gr), EUR.
ie — Irlanda (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Lettonia (vinted.lv), EUR.
si — Slovenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

filterenum<string>required

Quale filtro elencare.

Example: size

size — Taglie, raggruppate per categoria; invia category_id. Gli id vanno in size_ids nella ricerca.
status — Condizioni (6 nuovo con cartellino, 1 nuovo senza cartellino, 2 ottime condizioni, 3 buone condizioni, 4 condizioni discrete). Gli id vanno in status_ids.
color — Colori. Gli id vanno in color_ids.
material — Materiali. Gli id vanno in material_ids.

querystring

Conta le opzioni per questa ricerca. Facoltativa.

Example: dress

category_idinteger

Conta le opzioni all'interno di questa categoria, per id da /api/v1/vinted/categories. Le taglie sono raggruppate per categoria, quindi indicane una per size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Taglie degli abiti da donna su vinted.co.uk con il numero di annunci per ognuna
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") # Taglie degli abiti da donna su vinted.co.uk con il numero di annunci per ognuna 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"))