Esiste un'API di Vinted? Un feed di annunci per server Discord e app di rivendita

Se gestisci un server Discord di sourcing, un'app di rivendita o un piccolo SaaS per chi vende su Vinted, ti serve sempre la stessa cosa alla base: un flusso costante di nuovi annunci Vinted che corrispondono a ciò che cercano i tuoi membri o clienti. La prima domanda che si fanno quasi tutti è se Vinted abbia un'API per questo.

Non ne pubblica una aperta. Vinted non offre alcuna API pubblica per leggere i nuovi annunci, quindi la maggior parte dei team finisce per scrivere uno scraper. Funziona per un po'. Poi arriva la manutenzione: proxy, richieste bloccate, una modifica alla pagina che di domenica rompe il tuo parser e una configurazione separata per ogni paese che aggiungi.

Vinotify è un servizio indipendente che si occupa di questa parte per te. Salvi le ricerche, Vinotify le controlla al posto tuo e ti consegna le nuove corrispondenze tramite un feed REST, webhook o MCP. Sarà il tuo server o la tua app a decidere cosa farne.

Il tuo scraper o un feed?

Se hai già uno scraper che funziona e ti piace tenerlo in vita, tienilo. La tabella qui sotto è per i team che preferiscono dedicare quel tempo ai propri membri o al proprio prodotto.

Una cosa va detta chiaramente: non è una copia completa di Vinted. Ricevi i nuovi annunci che corrispondono alle tue ricerche salvate, non ogni articolo del sito. Per un server di sourcing o un prodotto di avvisi, di solito è comunque ciò che vuoi.

Cosa trovi nel feed

Ogni ricerca salvata ha il suo flusso di eventi. Un evento contiene uno o più nuovi annunci, e ogni annuncio può includere l'id dell'articolo, il titolo, la marca, la taglia, la condizione, il prezzo, la valuta, l'URL di Vinted e una foto. L'evento ti dice anche la ricerca, il mercato e quando Vinotify l'ha trovato.

• Le ricerche a pagamento ricevono avvisi istantanei, così una corrispondenza ti arriva poco dopo la pubblicazione.
• Le ricerche possono filtrare per parole chiave, categoria, marca, taglia, condizione, prezzo, parole escluse e venditori bloccati.
• Il tuo codice può creare, aggiornare, mettere in pausa, riprendere ed eliminare ricerche con un token con permessi di scrittura, così membri o clienti possono gestire le proprie ricerche dal tuo bot o dalla tua app.
• Il feed non contiene nomi di venditori né profili. Ottieni l'annuncio, non la persona che c'è dietro.

Nomi dei campi, limiti e codici di errore sono nella documentazione per sviluppatori.

Collegarlo a un server Discord

Il payload di Vinotify non è nel formato webhook di Discord, quindi serve un piccolo ponte nel mezzo. La versione più semplice legge il feed di eventi di una ricerca e pubblica ogni nuovo annuncio su un webhook di un canale Discord:

import os, requests

API = "https://vinotify.me/api/v1/integrations"
HEADERS = {"Authorization": f"Bearer {os.environ['VINOTIFY_TOKEN']}"}
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]
SEARCH_ID = 42

cursor, seen = "0-0", set()
while True:
    r = requests.get(f"{API}/events", headers=HEADERS, timeout=40,
                     params={"search_id": SEARCH_ID, "cursor": cursor, "wait": 30})
    if r.status_code == 410:          # cursor older than 48 hours
        cursor = "0-0"
        continue
    r.raise_for_status()
    body = r.json()
    for event in body["events"]:
        if event["event_id"] in seen:
            continue
        seen.add(event["event_id"])
        for item in event["items"]:
            embed = {"title": item["title"], "url": item["url"],
                     "description": f"{item['price']} {item['currency']}"}
            if item.get("photo"):
                embed["image"] = {"url": item["photo"]}
            requests.post(DISCORD, json={"embeds": [embed]}, timeout=10)
    cursor = body["next_cursor"]

Questo è uno schizzo, non un bot finito. Uno vero salva il cursore su disco in modo che un riavvio non ripeta i vecchi articoli, aspetta Retry-After quando riceve un 429 e gestisce un canale per ricerca. Un token consente 12 long poll contemporanei e 240 richieste al minuto, quindi con più ricerche di così interrogale una alla volta senza wait.

Se preferisci che sia Vinotify a chiamarti, imposta invece una destinazione webhook su ogni ricerca. Il push è più rapido ma non viene ritentato, quindi la maggior parte dei server usa il feed in parallelo. La guida ai webhook copre entrambi.

Quanto costa

Feed, webhook e MCP sono inclusi nel piano Pro: €22.99 al mese nell'UE, £19.99 nel Regno Unito e $19.99 negli Stati Uniti, per 100 ricerche con avvisi istantanei. Sono circa 23 centesimi a ricerca. Una ricerca che controlla più di un mercato conta una volta per ogni mercato.

Se ti servono più di 100 ricerche, scrivi a support@vinotify.me. Le quote più alte si stabiliscono per singolo account. I dettagli completi dei piani sono nella pagina dei prezzi.

Tieni chiari i confini

Vinotify non è affiliato a Vinted. Controlla gli annunci pubblici per le tue ricerche salvate. Non chiede mai un login Vinted, non accede all'account di nessuno e non compra, non scrive messaggi e non aggiunge ai preferiti per conto di nessuno.

Gli annunci appartengono a chi li ha pubblicati. Collega ogni post all'annuncio originale, conserva solo ciò che serve al tuo servizio e verifica che il tuo uso rispetti i termini di Vinted e la legge del paese in cui operi. Questa parte spetta a te.

Per iniziare, crea un account Pro, aggiungi qualche ricerca e crea un token di sola lettura nella pagina Integrazioni. La panoramica sull'automazione ti guida attraverso le prime chiamate.