A Vinted tem uma API? Um feed de anúncios para servidores Discord e apps de revenda

Se gere um servidor Discord de sourcing, uma app de revenda ou um pequeno SaaS para vendedores da Vinted, precisa sempre da mesma coisa lá no fundo: um fornecimento constante de anúncios novos da Vinted que correspondam ao que os seus membros ou clientes procuram. A primeira pergunta da maioria das pessoas é se a Vinted tem uma API para isso.

Não publica uma aberta. A Vinted não oferece nenhuma API pública para ler anúncios novos, por isso a maioria das equipas acaba por escrever um scraper. Funciona durante algum tempo. Depois vem a manutenção: proxies, pedidos bloqueados, uma alteração de página que ao domingo estraga o seu parser e uma configuração separada para cada país que acrescenta.

A Vinotify é um serviço independente que trata dessa parte por si. Basta guardar as pesquisas: a Vinotify vigia-as por si e entrega-lhe as novas correspondências através de um feed REST, webhooks ou MCP. O seu servidor ou a sua app decide o que fazer com elas.

O seu próprio scraper ou um feed?

Se já tem um scraper que funciona e gosta de o manter vivo, fique com ele. A tabela abaixo é para equipas que preferem dedicar esse tempo aos seus membros ou ao seu produto.

Uma coisa tem de ficar clara: isto não é uma cópia completa da Vinted. Recebe os anúncios novos que correspondem às suas pesquisas guardadas, não todos os artigos do site. Para um servidor de sourcing ou um produto de alertas, normalmente é isso mesmo que quer.

O que recebe no feed

Cada pesquisa guardada tem o seu próprio fluxo de eventos. Um evento contém um ou mais anúncios novos, e cada anúncio pode incluir o id do artigo, o título, a marca, o tamanho, o estado, o preço, a moeda, o URL da Vinted e uma foto. O evento indica também a pesquisa, o mercado e quando a Vinotify o encontrou.

• As pesquisas pagas têm alertas instantâneos, por isso uma correspondência chega-lhe pouco depois de ser publicada.
• As pesquisas podem filtrar por palavras-chave, categoria, marca, tamanho, estado, preço, palavras excluídas e vendedores bloqueados.
• O seu código pode criar, atualizar, pausar, retomar e eliminar pesquisas com um token com permissão de escrita, para que membros ou clientes giram as suas próprias pesquisas a partir do seu bot ou da sua app.
• O feed não inclui nomes de vendedores nem perfis. Recebe o anúncio, não a pessoa por trás dele.

Os nomes dos campos, os limites e os códigos de erro estão na documentação para programadores.

Ligar a um servidor Discord

O payload da Vinotify não está no formato de webhook do Discord, por isso precisa de uma pequena ponte pelo meio. A versão mais simples lê o feed de eventos de uma pesquisa e publica cada anúncio novo num webhook de canal do 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"]

Isto é um esboço, não um bot acabado. Um bot a sério guarda o cursor em disco para que um reinício não repita artigos antigos, espera pelo Retry-After quando recebe um 429 e trata de um canal por pesquisa. Um token permite 12 long polls em simultâneo e 240 pedidos por minuto, por isso, com mais pesquisas do que isso, consulte uma de cada vez sem wait.

Se preferir que seja a Vinotify a chamá-lo, defina antes um destino webhook em cada pesquisa. O push é mais rápido mas não é repetido, por isso a maioria dos servidores corre o feed em paralelo. O guia de webhooks cobre ambos.

Quanto custa

O feed, os webhooks e o MCP vêm com o plano Pro: €22.99 por mês na UE, £19.99 no Reino Unido e $19.99 nos EUA, para 100 pesquisas com alertas instantâneos. Isso dá cerca de 23 cêntimos por pesquisa. Uma pesquisa que vigia mais do que um mercado conta uma vez por cada mercado.

Se precisar de mais de 100 pesquisas, escreva para support@vinotify.me. Os limites maiores são definidos por conta. Os detalhes completos dos planos estão na página de preços.

Mantenha os limites claros

A Vinotify não é afiliada à Vinted. Vigia anúncios públicos para as suas pesquisas guardadas. Nunca pede um início de sessão da Vinted, não entra na conta de ninguém e não compra, não envia mensagens nem marca favoritos em nome de ninguém.

Os anúncios pertencem às pessoas que os publicaram. Ligue cada publicação ao anúncio original, guarde apenas o que o seu serviço precisa e verifique se a sua utilização cumpre os termos da Vinted e a lei do país onde opera. Cabe-lhe a si decidir essa parte.

Para começar, crie uma conta Pro, adicione algumas pesquisas e crie um token só de leitura na página Integrações. A visão geral da automatização acompanha-o nas primeiras chamadas.