Vinted

API di ricerca Vinted

Cerca annunci di seconda mano su uno qualsiasi dei 27 siti Vinted per parole chiave, categoria, marca, condizioni, taglia, colore, materiale e fascia di prezzo, ordinati per pertinenza, dai più recenti o per prezzo. Per Vinted Italia invia "country": "it". 96 articoli per pagina, pagine da 1 a 10 (Vinted non va oltre). Ogni articolo riporta id, titolo, URL, prezzo e valuta (quella del sito), price_with_discount, service_fee (la tariffa Vinted che l'acquirente paga oltre al prezzo, prima chiamata Buyer Protection fee), total_price, marca, taglia, condizioni, numero di preferiti, se è in evidenza, foto e id del venditore con l'indicazione se è professionale. Restituisce anche listed_results, total_pages e total_is_capped, oltre ai filtri che Vinted ha applicato davvero, così vedi se uno è stato ignorato. Costa 1 credito per richiesta.

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

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.

querystring

Parole chiave, fino a 200 caratteri. Facoltativa se invii category_id o brand_ids (per sfogliare una categoria o una marca).

Example: barbour jacket

category_idinteger

Solo questa categoria e le sue sottocategorie, per id da /api/v1/vinted/categories (1907 sono i cappotti da donna, Women > Clothing > Outerwear > Coats su vinted.co.uk).

Example: 1907

brand_idsinteger[]

Solo queste marche, per id da /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805, Zara 12). Array o elenco separato da virgole, fino a 20.

Example: [46805]

status_idsinteger[]

Solo queste condizioni: 6 nuovo con cartellino, 1 nuovo senza cartellino, 2 ottime condizioni, 3 buone condizioni, 4 condizioni discrete. Array o elenco separato da virgole.

Example: [6, 1]

size_idsinteger[]

Solo queste taglie, per id di opzione da /api/v1/vinted/filters con filter size (4 è la M da donna / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Solo questi colori, per id di opzione da /api/v1/vinted/filters con filter color (1 è il nero).

Example: [1]

material_idsinteger[]

Solo questi materiali, per id di opzione da /api/v1/vinted/filters con filter material (123 è il cashmere).

Example: [123]

price_fromnumber

Prezzo minimo dell'articolo, nella valuta del sito.

Example: 20

price_tonumber

Prezzo massimo dell'articolo, nella valuta del sito. Non può essere inferiore a price_from.

Example: 80

sortstring

relevance (predefinito), newest_first, price_low_to_high o price_high_to_low. Gli ordinamenti per prezzo includono anche articoli poco pertinenti (annunci molto economici o con prezzi segnaposto), quindi abbinali a una categoria o a una fascia di prezzo.

pageinteger

Pagina dei risultati, 1-10. Vinted serve al massimo 10 pagine da 96. Predefinita: 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"], "articoli, pagina", res["page"], "di", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "con la tariffa Vinted", 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"], "articoli, pagina", res["page"], "di", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "con la tariffa Vinted", item["total_price"], item["condition"])