API do Mercado Livre

O 403 vem da API oficial do Mercado Livre, e a documentação para desenvolvedores dela é o lugar para diagnosticar uma recusa específica. O que vale para todas as chamadas: em outubro de 2026, essa API exige um aplicativo OAuth registrado no DevCenter do Mercado Livre e um access token de um usuário que autorizou esse app. Se o que você precisa são dados públicos de anúncios, a API do Mercado Livre do Scavio funciona com uma API key, sem app nem token de usuário: busca, produto, avaliações e perguntas de anúncios públicos no Brasil, México, Argentina e Colômbia. O que a API oficial exige e um exemplo sem OAuth com resultado real (em inglês).

O Mercado Livre tem uma API oficial para desenvolvedores, construída sobre OAuth 2.0: você registra um aplicativo no DevCenter do Mercado Livre, um usuário do Mercado Livre autoriza esse app e cada chamada leva o access token desse usuário, que expira em seis horas e precisa ser renovado. Ela foi feita para vendedores e integradores que trabalham com as próprias contas. A API do Mercado Livre do Scavio retorna dados públicos de anúncios com uma única API key, sem app nem OAuth: busca, produto, avaliações, perguntas e mais vendidos, 5 endpoints a 2 créditos cada (avaliações 1).

Não para o Scavio. Uma API key do Scavio cobre os 5 endpoints nos quatro países, sem app no DevCenter, sem client ID e client secret e sem renovar token a cada seis horas. Contas novas ganham 50 créditos grátis no cadastro, sem cartão.

Com a API do Scavio não há scraper para manter: você envia um POST com o país e uma busca ou um id de produto e recebe JSON estruturado, com os mesmos nomes de campo em todos os países. Para o Brasil, use country br na busca; produto, avaliações e perguntas aceitam qualquer URL do mercadolivre.com.br ou id MLB. Busca, ficha do produto, avaliações e perguntas custam a partir de 1 crédito por chamada, sem registrar app nem pedir autorização a um usuário.

Na busca, os resultados do Brasil costumam mostrar o preço no Pix, cerca de 5% abaixo do preço normal. O endpoint de produto retorna o preço normal e costuma listar a oferta no Pix em promotions. Em 11 de outubro de 2026, um iPhone 15 aparecia por R$ 4.009 na busca e por R$ 4.220,84 no endpoint de produto. Para comparar preços entre anúncios, use sempre a mesma fonte.

Brasil (br, Mercado Livre), México (mx), Argentina (ar) e Colômbia (co). Busca, produto, avaliações e perguntas funcionam nos quatro; mais vendidos funciona no México, na Argentina e na Colômbia, mas não no Brasil. O Chile não é suportado. Para produto, avaliações e perguntas, o país vem do prefixo do id (MLB Brasil, MLM México, MLA Argentina, MCO Colômbia) ou da URL.

Só como a faixa que o Mercado Livre mostra. sold_quantity_min é um mínimo (1000 para "+1000 vendidos") e sold_label traz o texto como aparece. O Mercado Livre mostra as vendas em faixas, então não há um número exato. Na busca capturada de iPhone 15, as faixas iam de 25 a 10.000.

Sim. Cada resultado traz brand, rating e review_count, lidos da mesma página de resultados, então acompanhar marcas e totais de avaliações numa busca inteira custa 2 créditos por página, sem uma chamada de produto por anúncio. Em 16 de outubro de 2026, uma busca por "fone bluetooth" no Mercado Livre retornou a marca nos 48 resultados orgânicos e o número de avaliações em 43. A cobertura de review_count varia conforme a busca e é null, nunca 0, quando a página não publica um total. A maioria dos resultados patrocinados retorna review_count null.

Sim. Os preços vêm na moeda local do site (BRL no Brasil, e MXN, ARS ou COP nos outros), com a moeda em cada resultado. Cada anúncio traz price, original_price e discount_percent quando está em promoção, e o parcelamento (count, amount e um indicador interest_free para parcelas sem juros). A busca filtra por min_price, max_price e min_discount e ordena por preço crescente ou decrescente.

Sim. Avaliações retorna 15 por página por 1 crédito, filtráveis por estrelas, com texto, data exata, curtidas, fotos e o país onde cada avaliação foi escrita; as traduzidas mantêm o texto original. Perguntas retorna as perguntas dos compradores com a resposta do vendedor e a data da resposta. O Mercado Livre não mostra a data da pergunta, então ela não é retornada. No Brasil, o endpoint de produto costuma trazer a nota média e o total de avaliações, mas não a distribuição de estrelas. As avaliações de catálogo juntam países: em 11 de outubro de 2026, 10 das 12 avaliações da primeira página do iPhone 15 mexicano foram escritas no Brasil e traduzidas, com o original em português.

Não. O endpoint de mais vendidos retorna o top 20 de uma categoria no México, na Argentina e na Colômbia, mas a lista do Brasil não está disponível. No Brasil, a busca com ordenação por preço e as faixas de unidades vendidas de cada resultado são o caminho para pesquisar uma categoria.

Cerca de 48 anúncios por página e até 42 páginas, ou seja, uns 2.000 resultados por busca. Cada resposta traz total e total_pages. Para ir mais fundo, divida a busca por faixa de preço, condição ou vendedor e faça uma busca por fatia. A ordenação é por relevância ou por preço; o Mercado Livre não oferece ordenação por mais novos nem por mais vendidos.

Sim. A busca aceita um seller_id (o id numérico que o endpoint de produto retorna para o vendedor do buy box) e o combina com uma busca, todos os filtros, a ordenação e a página. Um seller_nickname retorna a primeira página de anúncios do vendedor e o seller_id dele. Só dados públicos de anúncios são retornados, nunca dados de contato do vendedor.

Busca, produto, perguntas e mais vendidos custam 2 créditos por chamada; avaliações custam 1. No plano Growth com pagamento anual (US$ 2 por 1.000 créditos), são US$ 0,004 por página de busca de cerca de 48 anúncios, uns US$ 0,08 por 1.000 anúncios, e US$ 0,002 por página de 15 avaliações. Um produto, anúncio ou vendedor que não existe retorna 404 e é cobrado; falhas temporárias não são cobradas. Contas novas ganham 50 créditos grátis sem cartão, e os planos pagos começam em US$ 30 por mês por 7.000 créditos.

O Scavio retorna dados públicos do Mercado Livre: o que qualquer pessoa vê numa página pública do Mercado Livre, como anúncios, preços, avaliações e perguntas respondidas. Não retorna dados de contato de compradores ou vendedores nem nada que esteja atrás de login. Se o seu uso específico é permitido depende da sua jurisdição, do seu caso de uso e dos termos do Mercado Livre, e você é responsável pelo uso que faz dos dados. Isto não é aconselhamento jurídico; consulte seu próprio advogado.

Cada requisição lê o Mercado Livre ao vivo no momento da chamada, então mudanças de preço, anúncios novos e avaliações novas aparecem assim que o Mercado Livre as mostra. Nada vem de uma cópia em cache. Para acompanhar preços ao longo do tempo, salve as respostas de forma agendada e compare.