API da Vinted Portugal

A Vinted tem uma API oficial, a Vinted Pro Integrations, mas está disponível apenas para um grupo restrito de empresas Vinted Pro autorizadas e serve para uma empresa gerir os seus próprios artigos e encomendas; não inclui pesquisa no marketplace (pro-docs.svc.vinted.com, consultado a 9 de novembro de 2026). A API da Vinted do Scavio é uma alternativa à parte, aberta a qualquer pessoa que se registe: 9 endpoints POST que devolvem em JSON estruturado o que os 27 sites nacionais da Vinted mostram, com uma única API key.

Sim. Envie "country": "pt" em cada pedido e os 9 endpoints consultam a vinted.pt, com preços em EUR e os nomes de categorias, estados e filtros em português, como "Novo sem etiquetas", "Muito bom" ou "Mulher > Roupa". Cada chamada custa 1 crédito.

Os 27 sites da Vinted, escolhidos com o parâmetro country: fr (a predefinição), be, lu, es, nl, lt, de, at, it, pt, sk, fi, hr, gr, ie, ee, lv e si em EUR, cz em CZK, pl em PLN, se em SEK, ro em RON, hu em HUF, dk em DKK, uk (vinted.co.uk) em GBP, us (vinted.com) em USD e au (vinted.com.au) em AUD. Os nomes de categorias, estados e filtros vêm na língua de cada site.

Os sites da UE partilham um único conjunto de anúncios transfronteiriço. Uma pesquisa na vinted.pt devolve anúncios de vendedores de toda a UE, com preços em EUR e títulos que podem estar noutras línguas: na pesquisa "vestido" de 9 de novembro de 2026, o segundo resultado tinha o título italiano "Vestito Urban Outfitters con gonnapantalone". Os mesmos anúncios aparecem na vinted.pl com preços em PLN. A vinted.co.uk, a vinted.com e a vinted.com.au também podem mostrar anúncios de vendedores de outros países, com o preço convertido: numa pesquisa na vinted.co.uk, um anúncio Levi's a 10,43 £ custava 20 AUD na página de produto, o preço de um vendedor na Austrália. A página de um produto mostra o preço na moeda do próprio vendedor, que pode ser diferente da que a pesquisa desse site mostra.

service_fee é a taxa que o comprador paga à Vinted por cima do preço do artigo, e total_price é o preço mais essa taxa. Os termos da Vinted de 8 de outubro de 2026 mudaram o nome da taxa de Proteção do Comprador para taxa da Vinted (Vinted fee). Um Vestido Stradivarius a 8 EUR na vinted.pt tinha uma taxa da Vinted de 1,10 EUR e um total de 9,10 EUR. Os portes não estão incluídos; a API não devolve preços de envio.

Não. A pesquisa devolve apenas artigos à venda, não existe pesquisa de anúncios vendidos nem histórico de preços de venda, por isso a API não serve para comparáveis de vendas. O que pode obter: uma consulta de produto a um anúncio já vendido devolve is_sold true e o último preço, e a pesquisa mostra os preços pedidos atualmente, com a taxa da Vinted, por marca, tamanho e estado.

96 artigos por página, páginas 1 a 10: a Vinted serve no máximo 960 resultados por pesquisa. Quando total_is_capped é true há mais resultados do que esses, por isso afine com category_id, brand_ids, size_ids, status_ids ou um intervalo de preço. "vestido" na vinted.pt chegou a esse limite. As ordenações por preço também incluem anúncios que só correspondem vagamente, por isso combine-as com uma categoria ou um intervalo de preço.

Chame /api/v1/vinted/search com os seus filtros e a ordenação newest_first de forma periódica, guarde os ids que já viu e publique cada anúncio novo no Discord, no Telegram ou no Slack com preço, tamanho, estado e URL. Cada verificação custa 1 crédito: uma pesquisa verificada a cada 5 minutos são 288 créditos por dia. O Scavio devolve apenas dados; não compra, não envia mensagens a vendedores e não faz propostas.

Apenas campos públicos e relevantes para quem compra: login, indicação de profissional, número de avaliações, classificação, avaliações positivas, neutras e negativas, artigos à venda, país, cidade quando o membro a mostra, verificações, tempo médio de resposta, modo de férias e data da última visita, além dos artigos à venda e das avaliações. A maioria dos vendedores da Vinted são particulares, por isso não há nome verdadeiro, morada, lista de seguidores nem hora exata do último acesso, e as avaliações vêm sem a identidade de quem as deixou.

Sim. /api/v1/vinted/brands converte um nome num id de marca (Barbour é 46805, Nike 53), /api/v1/vinted/filters lista os ids de tamanho, estado, cor e material com contagens em tempo real, e /api/v1/vinted/categories dá os ids de categoria. Passe-os à pesquisa como brand_ids, size_ids, status_ids, color_ids, material_ids e category_id. A pesquisa repete os filtros que a Vinted aplicou, por isso um filtro ignorado fica visível.

Os termos e condições da Vinted (versão aplicável a partir de 8 de outubro de 2026) proíbem os utilizadores de usar ferramentas de software externas, como bots, programas de scraping, crawlers ou spiders, salvo se essa utilização for autorizada, oferecida ou de outra forma permitida pela Vinted. O Scavio devolve dados públicos da Vinted e não inicia sessão em contas da Vinted, não compra artigos, não envia mensagens a vendedores nem altera anúncios. É responsável pela forma como utiliza os dados; consulte o seu próprio advogado para o seu caso.

O Scavio dá 50 créditos gratuitos no registo, uma única vez e sem cartão, o que cobre 50 chamadas à Vinted, já que todos os endpoints custam 1 crédito. Os planos pagos começam em 15 USD por mês por 3000 créditos; no plano Growth (1 USD por 1000 créditos) isso dá 1 USD por cada 1000 chamadas à Vinted.

Cada endpoint da Vinted custa 1 crédito por chamada: uma página de pesquisa de 96 artigos, um produto, um perfil de vendedor, até 96 artigos ou 50 avaliações de um vendedor, marcas, sugestões, filtros e a árvore de categorias. Os pedidos inválidos (400), os artigos, membros ou categorias desconhecidos (404) e as falhas temporárias (502) não são cobrados.

Cada pedido consulta a Vinted em direto no momento da chamada, e cada resposta traz fetched_at; só a árvore de categorias é reutilizada durante até 12 horas por site. Nas nossas capturas, a pesquisa demorou 6,3 segundos, o produto 3,1, o vendedor 2,7, as avaliações 2,4, as marcas 1,9 e as sugestões 2,6. As verificações a montante falham por vezes; a API repete automaticamente, e uma chamada que continue a falhar dá um 502 que não é cobrado.

Não há pesquisa de anúncios vendidos nem comparáveis de vendas, preços de envio, pontos de recolha, artigos semelhantes, tendências, número de visualizações dos artigos, nem forma de publicar, editar ou comprar anúncios. A API lê apenas dados públicos da Vinted.