API Vinted Italia

Vinted ha un'API ufficiale, Vinted Pro Integrations, ma è riservata a un gruppo ristretto di aziende Vinted Pro ammesse in una lista ("available only to a limited set of allowlisted Vinted Pro businesses") e serve a gestire gli articoli e gli ordini dell'azienda stessa; non offre la ricerca nel marketplace (pro-docs.svc.vinted.com, verificato il 9 novembre 2026). La Vinted API di Scavio è un'alternativa aperta a chiunque si registri: 9 endpoint POST che restituiscono in JSON strutturato quello che mostrano i 27 siti Vinted, con una sola API key.

Aggiungi "country": "it" al corpo di ogni richiesta e l'API interroga vinted.it, con prezzi in euro. Se non lo indichi, il valore predefinito è fr (vinted.fr). Tutti e 9 gli endpoint funzionano su vinted.it.

Tutti i 27 siti Vinted, da scegliere con il parametro country: fr (predefinito), be, lu, es, nl, lt, de, at, it, pt, sk, fi, hr, gr, ie, ee, lv e si in EUR, cz in CZK, pl in PLN, se in SEK, ro in RON, hu in HUF, dk in DKK, uk (vinted.co.uk) in GBP, us (vinted.com) in USD e au (vinted.com.au) in AUD. Nomi delle categorie, condizioni e filtri arrivano nella lingua di ciascun sito.

Perché i siti UE condividono un unico bacino di annunci transfrontaliero. Cercando "vestito" su vinted.it sono usciti annunci con titoli in olandese e francese, come "Zara geweldig gebreid vest!". Cambia la presentazione: un abito Maje da 50 € aveva taglia "IT 42" e condizioni "Nuovo con cartellino" su vinted.it, e "EU 38" e "Nuevo con etiquetas" su vinted.es. Anche i siti di Regno Unito, Stati Uniti e Australia possono mostrare annunci di venditori di altri paesi, con il prezzo convertito: in una ricerca su vinted.co.uk, un annuncio Levi's a 10,43 £ costava 20 AUD nella sua scheda, fissati da un venditore in Australia. La scheda di un articolo mostra il prezzo nella valuta del venditore.

service_fee è quanto l'acquirente paga a Vinted oltre al prezzo dell'articolo, e total_price è la somma dei due. I termini di Vinted dell'8 ottobre 2026 l'hanno rinominata da Buyer Protection fee (tariffa di protezione acquisti) a Vinted fee (tariffa Vinted). Su vinted.it un vestito nero Suite Benedict da 10 € aveva 1,20 € di tariffa e un totale di 11,20 €; un abito invernale da 3 €, 0,85 € e 3,85 €. La spedizione non è inclusa: l'API non restituisce i costi di spedizione.

Sì, con "country": "it" le etichette sono quelle di vinted.it. Il vestito Suite Benedict della cattura aveva condizioni "Ottime", colore "Nero", categoria Donna > Vestiti > Abiti > Tubini neri e data di caricamento "un giorno fa". L'albero completo di vinted.it parte da Donna, Uomo, Articoli griffati, Bambini, Casa, Elettronica, Libri e media, Hobby e collezionismo e Sport. Titoli e descrizioni sono quelli scritti da ogni venditore, nella sua lingua.

No. La ricerca restituisce solo articoli in vendita: non esiste una ricerca degli annunci venduti né uno storico dei prezzi di vendita, quindi l'API non fornisce comparabili di vendita. Cosa puoi fare: la scheda di un annuncio già venduto restituisce is_sold true e l'ultimo prezzo, e la ricerca mostra i prezzi di vendita attuali con la tariffa Vinted per marca, taglia e condizioni.

96 articoli per pagina, pagine da 1 a 10: Vinted serve al massimo 960 risultati per ricerca. Se total_is_capped è true le corrispondenze sono di più, quindi restringi con category_id, brand_ids, size_ids, status_ids o una fascia di prezzo. "vestito" su vinted.it ha raggiunto il limite. Gli ordinamenti per prezzo includono anche annunci poco pertinenti, quindi abbinali a una categoria o a una fascia di prezzo.

Chiama /api/v1/vinted/search con i tuoi filtri e sort newest_first a intervalli regolari, tieni traccia degli id già visti e invia ogni nuovo annuncio a Discord, Telegram o Slack con prezzo, taglia, condizioni e URL. Ogni controllo costa 1 credito: una ricerca controllata ogni 5 minuti fa 288 crediti al giorno. Scavio restituisce solo dati: non compra, non scrive ai venditori e non fa offerte.

Solo campi pubblici utili a un acquirente: nome utente, se è professionale, numero di feedback, valutazione, feedback positivi, neutri e negativi, articoli in vendita, paese, città se il membro la mostra, verifiche, tempo medio di risposta, modalità vacanza e data dell'ultimo accesso, oltre agli articoli in vendita e ai feedback. Su Vinted vendono soprattutto privati, quindi niente nome reale, indirizzo, elenco dei follower o orario esatto di accesso, e i feedback arrivano senza l'identità di chi li ha scritti.

Sì. /api/v1/vinted/brands trasforma un nome in un id di marca (Zara è 12, Nike 53), /api/v1/vinted/filters elenca gli id di taglia, condizioni, colore e materiale con il numero di articoli e /api/v1/vinted/categories fornisce gli id delle categorie. Passali alla ricerca come brand_ids, size_ids, status_ids, color_ids, material_ids e category_id. Gli id sono gli stessi su tutti i siti, e la ricerca restituisce i filtri che Vinted ha applicato davvero, così vedi se uno è stato ignorato.

I termini e condizioni di Vinted (versione in vigore dall'8 ottobre 2026) vietano agli utenti di usare strumenti software esterni, come bot, programmi di scraping, crawler o spider, a meno che l'uso non sia autorizzato, offerto o comunque consentito da Vinted. Scavio restituisce dati pubblici di Vinted e non accede ad account Vinted, non compra articoli, non scrive ai venditori e non modifica annunci. Sei tu responsabile dell'uso che fai dei dati; per il tuo caso specifico rivolgiti al tuo legale.

Scavio ti dà 50 crediti gratuiti alla registrazione, una sola volta e senza carta, pari a 50 chiamate Vinted perché ogni endpoint costa 1 credito. I piani a pagamento partono da 15 USD al mese per 3000 crediti; con il piano Growth (1 USD ogni 1000 crediti) sono 1 USD ogni 1000 chiamate Vinted.

Ogni endpoint Vinted costa 1 credito a chiamata: una pagina di ricerca da 96 articoli, una scheda, un profilo venditore, fino a 96 articoli o 50 feedback di un venditore, marche, suggerimenti, filtri e l'albero delle categorie. Le richieste non valide (400), gli articoli, i membri o le categorie inesistenti (404) e i disservizi temporanei (502) non vengono addebitati.

Ogni richiesta legge Vinted in tempo reale al momento della chiamata e ogni risposta riporta fetched_at; solo l'albero delle categorie viene riutilizzato per un massimo di 12 ore per sito. Nei nostri test su vinted.it del 9 novembre 2026 una ricerca ha impiegato 3,9 secondi e una scheda articolo 14,2. A volte i controlli a monte non vanno a buon fine; l'API riprova automaticamente, e una chiamata che continua a fallire restituisce un 502 che non viene addebitato.

Nessuna ricerca di annunci venduti né comparabili di vendita, nessun costo di spedizione o punto di ritiro, nessun articolo simile, nessuna tendenza, nessun numero di visualizzazioni degli articoli e nessun modo di pubblicare, modificare o comprare annunci. Legge solo dati pubblici di Vinted.