¿Existe una API de Vinted? Un feed de anuncios para servidores de Discord y apps de reventa

Si gestionas un servidor de Discord de sourcing, una app de reventa o un pequeño SaaS para vendedores de Vinted, necesitas siempre lo mismo en el fondo: un suministro constante de anuncios nuevos de Vinted que coincidan con lo que buscan tus miembros o clientes. La primera pregunta que se hace casi todo el mundo es si Vinted tiene una API para eso.

No publica una abierta. Vinted no ofrece ninguna API pública para leer anuncios nuevos, así que la mayoría de los equipos acaban escribiendo un scraper. Funciona durante un tiempo. Luego llega el mantenimiento: proxies, solicitudes bloqueadas, un cambio de página que rompe tu parser un domingo y una configuración distinta por cada país que añades.

Vinotify es un servicio independiente que se encarga de esa parte por ti. Guardas búsquedas, Vinotify las vigila por ti y te entrega las coincidencias nuevas mediante un feed REST, webhooks o MCP. Tu servidor o tu app decide qué hacer con ellas.

¿Tu propio scraper o un feed?

Si ya tienes un scraper que funciona y te gusta mantenerlo vivo, quédatelo. La tabla de abajo es para equipos que prefieren dedicar ese tiempo a sus miembros o a su producto.

Una cosa debe quedar clara: esto no es una copia completa de Vinted. Recibes los anuncios nuevos que coinciden con tus búsquedas guardadas, no todos los artículos del sitio. Para un servidor de sourcing o un producto de alertas, normalmente es justo lo que quieres.

Qué incluye el feed

Cada búsqueda guardada tiene su propio flujo de eventos. Un evento contiene uno o más anuncios nuevos, y cada anuncio puede incluir el id del artículo, el título, la marca, la talla, el estado, el precio, la moneda, la URL de Vinted y una foto. El evento también indica la búsqueda, el mercado y cuándo lo encontró Vinotify.

• Las búsquedas de pago tienen alertas instantáneas, así que una coincidencia te llega poco después de publicarse.
• Las búsquedas pueden filtrar por palabras clave, categoría, marca, talla, estado, precio, palabras excluidas y vendedores bloqueados.
• Tu código puede crear, actualizar, pausar, reanudar y eliminar búsquedas con un token con permiso de escritura, para que tus miembros o clientes gestionen sus propias búsquedas desde tu bot o tu app.
• El feed no incluye nombres de vendedores ni perfiles. Obtienes el anuncio, no a la persona que hay detrás.

Los nombres de los campos, los límites y los códigos de error están en la documentación para desarrolladores.

Conectarlo a un servidor de Discord

El payload de Vinotify no está en el formato de webhook de Discord, así que necesitas un pequeño puente entre ambos. La versión más sencilla lee el feed de eventos de una búsqueda y publica cada anuncio nuevo en un webhook de canal de 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"]

Esto es un boceto, no un bot terminado. Uno de verdad guarda el cursor en disco para que un reinicio no repita artículos antiguos, espera el Retry-After cuando recibe un 429 y gestiona un canal por búsqueda. Un token permite 12 long polls simultáneos y 240 solicitudes por minuto, así que con más búsquedas que eso, consulta cada una por turnos sin wait.

Si prefieres que Vinotify te llame a ti, configura en su lugar un destino webhook en cada búsqueda. El push es más rápido pero no se reintenta, por eso la mayoría de los servidores ejecutan el feed a la vez. La guía de webhooks cubre ambos.

Cuánto cuesta

El feed, los webhooks y el MCP vienen con el plan Pro: €22.99 al mes en la UE, £19.99 en el Reino Unido y $19.99 en EE. UU., por 100 búsquedas con alertas instantáneas. Eso sale a unos 23 céntimos por búsqueda. Una búsqueda que vigila más de un mercado cuenta una vez por cada mercado.

Si necesitas más de 100 búsquedas, escribe a support@vinotify.me. Los límites mayores se fijan por cuenta. Los detalles completos de los planes están en la página de precios.

Mantén claros los límites

Vinotify no está afiliado a Vinted. Vigila anuncios públicos para tus búsquedas guardadas. Nunca pide un inicio de sesión de Vinted, no entra en la cuenta de nadie y no compra, envía mensajes ni marca favoritos en nombre de nadie.

Los anuncios pertenecen a quienes los publicaron. Enlaza cada publicación con el anuncio original, conserva solo lo que necesita tu servicio y comprueba que tu uso se ajusta a las condiciones de Vinted y a la ley del país donde operas. Esa parte te corresponde decidirla a ti.

Para empezar, crea una cuenta Pro, añade unas cuantas búsquedas y crea un token de solo lectura en la página Integraciones. La visión general de la automatización te guía por las primeras llamadas.