Existe-t-il une API Vinted ? Un flux d'annonces pour les serveurs Discord et les applis de revente

Si vous gérez un serveur Discord de sourcing, une appli de revente ou un petit SaaS pour les vendeurs Vinted, il vous faut au fond toujours la même chose : un flux régulier de nouvelles annonces Vinted qui correspondent à ce que cherchent vos membres ou vos clients. La première question que se posent la plupart des gens est de savoir si Vinted propose une API pour cela.

Vinted n'en publie pas d'ouverte. Il n'existe aucune API publique pour lire les nouvelles annonces, alors la plupart des équipes finissent par écrire un scraper. Ça marche un temps. Puis vient la maintenance : proxys, requêtes bloquées, un changement de page qui casse votre parseur un dimanche, et une configuration distincte pour chaque pays ajouté.

Vinotify est un service indépendant qui s'occupe de cette partie à votre place. Vous enregistrez des recherches, Vinotify les surveille pour vous et vous remet les nouvelles correspondances via un flux REST, des webhooks ou le MCP. Votre serveur ou votre appli décide ensuite quoi en faire.

Votre propre scraper ou un flux ?

Si vous avez déjà un scraper qui fonctionne et que vous aimez le maintenir en vie, gardez-le. Le tableau ci-dessous s'adresse aux équipes qui préfèrent consacrer ce temps à leurs membres ou à leur produit.

Une précision importante : ce n'est pas une copie complète de Vinted. Vous recevez les nouvelles annonces qui correspondent à vos recherches enregistrées, pas tous les articles du site. Pour un serveur de sourcing ou un produit d'alertes, c'est généralement ce qu'il vous faut de toute façon.

Ce que contient le flux

Chaque recherche enregistrée a son propre flux d'événements. Un événement contient une ou plusieurs nouvelles annonces, et chaque annonce peut inclure l'identifiant de l'article, le titre, la marque, la taille, l'état, le prix, la devise, l'URL Vinted et une photo. L'événement indique aussi la recherche, le marché et le moment où Vinotify l'a trouvé.

• Les recherches payantes bénéficient d'alertes instantanées : une correspondance vous parvient peu après sa mise en ligne.
• Les recherches peuvent filtrer par mots-clés, catégorie, marque, taille, état, prix, mots exclus et vendeurs bloqués.
• Votre code peut créer, modifier, mettre en pause, reprendre et supprimer des recherches avec un token en écriture, afin que vos membres ou clients gèrent eux-mêmes leurs recherches depuis votre bot ou votre appli.
• Le flux ne contient ni noms de vendeurs ni profils. Vous obtenez l'annonce, pas la personne qui se cache derrière.

Les noms de champs, les limites et les codes d'erreur sont détaillés dans la documentation développeur.

Brancher le flux sur un serveur Discord

Le format de Vinotify n'est pas celui des webhooks Discord : il faut donc un petit pont entre les deux. La version la plus simple lit le flux d'événements d'une recherche et publie chaque nouvelle annonce sur un webhook de salon 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"]

Ceci est une esquisse, pas un bot terminé. Un vrai bot enregistre le curseur sur disque pour qu'un redémarrage ne rejoue pas d'anciens articles, attend le délai indiqué par Retry-After quand il reçoit un 429, et gère un salon par recherche. Un token autorise 12 long polls simultanés et 240 requêtes par minute ; au-delà, interrogez chaque recherche à tour de rôle sans wait.

Si vous préférez que Vinotify vous appelle, définissez plutôt une destination webhook sur chaque recherche. Le push est plus rapide mais, en cas d'échec, aucune nouvelle tentative n'est faite ; la plupart des serveurs font donc tourner le flux en parallèle. Le guide des webhooks couvre les deux.

Combien ça coûte

Le flux, les webhooks et le MCP sont inclus dans la formule Pro : €22.99 par mois dans l'UE, £19.99 au Royaume-Uni et $19.99 aux États-Unis, pour 100 recherches avec alertes instantanées. Cela représente environ 23 centimes la recherche. Une recherche qui surveille plusieurs marchés compte une fois pour chaque marché.

Si vous avez besoin de plus de 100 recherches, écrivez à support@vinotify.me. Les quotas plus élevés sont définis compte par compte. Tous les détails des formules sont sur la page des tarifs.

Garder les limites claires

Vinotify n'est pas affilié à Vinted. Il surveille les annonces publiques correspondant à vos recherches enregistrées. Il ne demande jamais d'identifiants Vinted, ne se connecte au compte de personne et n'achète, n'envoie de message ni n'ajoute en favori au nom de qui que ce soit.

Les annonces appartiennent à ceux qui les ont publiées. Faites pointer chaque publication vers l'annonce d'origine, ne conservez que ce dont votre service a besoin, et vérifiez que votre usage respecte les conditions de Vinted et la loi du pays où vous opérez. Cela, c'est à vous d'en décider.

Pour commencer, créez un compte Pro, ajoutez quelques recherches et créez un token en lecture seule sur la page Intégrations. La présentation de l'automatisation détaille les premiers appels.