API do Mercado Livre para produtos: como buscar preços, vendas e avaliações sem OAuth

Para buscar produtos do Mercado Livre por API, envie um POST para https://api.scavio.dev/api/v1/mercadolibre/search da API do Mercado Livre da Scavio com {"country": "br", "query": "fone bluetooth"}. A resposta traz uma página de anúncios do mercadolivre.com.br com preço em reais, preço original, desconto, parcelas, marca, nota, número de avaliações, faixa de vendas e frete. Custa 2 créditos por página, e com os ids de cada linha você abre a ficha do produto, as avaliações e as perguntas, sem registrar app no DevCenter nem fazer OAuth.

A API oficial do Mercado Livre foi feita para vendedores e integradores: exige um app no DevCenter, um fluxo OAuth 2.0 com um usuário que autoriza o app e a renovação do access token a cada seis horas. A Scavio devolve os dados públicos dos anúncios com uma única API key. Tudo abaixo vem de respostas reais capturadas em 2 de novembro de 2026 no Mercado Livre Brasil.

O que você precisa

• Uma API key da Scavio. No cadastro você ganha 50 créditos grátis, sem cartão e sem conta no Mercado Livre.
• Qualquer linguagem que faça requisições HTTP. Os exemplos usam cURL e Python.

Passo 1: busque os produtos

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"country": "br", "query": "fone bluetooth", "free_shipping": true}'

A busca retornou 60 linhas, 12 delas patrocinadas e marcadas com sponsored: true, de um total de 115.568 resultados em 42 páginas. Esta é a oitava linha, recortada, sem nenhum valor alterado:

{
  "position": 8,
  "sponsored": false,
  "item_id": "MLB5879981504",
  "product_id": "MLB52845211",
  "title": "Fone Bluetooth Samsung Galaxy Buds Core Preto",
  "url": "https://www.mercadolivre.com.br/fone-bluetooth-samsung-galaxy-buds-core-preto/p/MLB52845211",
  "price": 242.48,
  "original_price": 349,
  "discount_percent": 30,
  "currency": "BRL",
  "installments": { "count": 6, "amount": 41.66, "interest_free": true },
  "seller": { "name": "Samsung", "official_store": true },
  "brand": "Samsung",
  "rating": 4.9,
  "review_count": 33444,
  "sold_quantity_min": 100000,
  "free_shipping": true,
  "full_fulfillment": true,
  "category_id": "MLB196208",
  "domain_id": "MLB-HEADPHONES"
}

Nas 60 linhas, todas tinham Full, 51 traziam marca, 47 o número de avaliações e 18 parcelas sem juros; 3 eram de compra internacional (cross_border: true). Os campos mais usados:

Filtros disponíveis: condition, min_price e max_price, min_discount, free_shipping, full_fulfillment, official_stores_only e interest_free_installments. A ordem é por relevância ou preço (sort), e "page": 2 avança até total_pages. Mais na documentação de busca.

Passo 2: abra a ficha do produto

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "MLB52845211"}'

Não precisa de country: o prefixo MLB do id já indica o Brasil. Resposta recortada:

{
  "product_id": "MLB52845211",
  "item_id": "MLB5879981504",
  "condition": "new",
  "sold_quantity_min": 100000,
  "sold_label": "+100 mil vendidos",
  "price": 249.98,
  "original_price": 349,
  "discount_percent": 30,
  "currency": "BRL",
  "installments": { "count": 6, "amount": 41.66, "total": 249.96, "interest_free": true },
  "promotions": [{ "type": "payment", "text": "no Pix" }],
  "rating": {
    "average": 4.9,
    "count": 45393,
    "distribution": { "1": 342, "2": 140, "3": 444, "4": 1987, "5": 42480 }
  },
  "seller": {
    "name": "Samsung",
    "reputation_level": "5_green",
    "power_seller_status": "platinum",
    "store_type": "OFFICIAL_STORE",
    "sales_label": "+1 M vendas"
  },
  "stock": { "available": true, "available_label": "+50 disponíveis" },
  "shipping": { "free_shipping": true, "logistic_type": "fulfillment", "mode": "me2" }
}

Dois detalhes que pegam quem monta um monitor de preços. Primeiro, o preço: a busca mostrou R$ 242,48 e a ficha R$ 249,98, porque o card da busca exibe o preço no Pix e a ficha traz o preço normal, com a oferta no Pix listada em promotions. Segundo, as avaliações: a busca mostrou 33.444 e a ficha 45.393, porque o produto de catálogo soma avaliações de outros países. A ficha também trouxe 25 especificações, a descrição, 10 imagens e as variações de cor (Branco e Preto) com o product_id de cada uma. Veja a documentação de produto.

Passo 3: leia as avaliações

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/reviews' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "MLB52845211"}'

Cada página traz 15 avaliações por 1 crédito. Na primeira, 12 eram do Brasil e 3 do México, traduzidas pelo Mercado Livre. Uma delas, com a foto recortada:

{
  "review_id": 2346208726,
  "rating": 4,
  "text": "Eles funcionam mais ou menos, esperava que tivessem mais volume, mas não, também não funciona muito bem a cancelamento de ruído. Esperava mais pelo preço e pela marca. Além disso, eu tenho um telefone samsung e pensei que ia funcionar melhor :/.",
  "original_text": "Se escuchan más o menos, esperaba que tuvieran más volumen pero no, tampoco funciona muy bien la cancelación de ruido. Esperaba más por el precio y por la marca. Además que yo tengo un teléfono samsung y pensé que iba a funcionar mejor:/.",
  "translated": true,
  "created_at": "2025-09-15T20:34:58Z",
  "likes": 110,
  "country": "mx",
  "reviewer_country": "México"
}

Se você analisa o que o consumidor brasileiro diz, filtre por country igual a br; o texto original fica em original_text. Para ver só as notas baixas, envie "rating": 1. Veja a documentação de avaliações.

Passo 4: extraia as perguntas dos compradores

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/questions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"item_id": "MLB5879981504"}'

A primeira página trouxe 20 perguntas, todas respondidas, com respostas datadas de 10 de outubro a 2 de novembro de 2026:

{
  "question_id": 13683654055,
  "text": "Funciona com iPhone",
  "answer": {
    "text": "Olá, tudo bem? Sim, o Galaxy Buds Core funciona com o iPhone, pois ele utiliza a tecnologia padrão Bluetooth 5.4. Aguardamos sua compra e permanecemos à disposição!",
    "date": "2026-11-02"
  }
}

Para a próxima página, envie o next_offset da resposta (aqui, 20) como offset. O Mercado Livre não mostra a data da pergunta, só a da resposta. Veja a documentação de perguntas.

Todos os endpoints para o Brasil

A lista de mais vendidos por categoria existe para México, Argentina e Colômbia, mas não para o Brasil.

Limites que vale conhecer

• Vendas vêm em faixas, nunca em números exatos: sold_quantity_min é o piso da faixa que o Mercado Livre mostra.
• Uma busca vai até 42 páginas, cerca de 2.000 resultados. Para ir além, divida por faixa de preço, condição ou vendedor.
• A ordem é por relevância ou preço; não há ordem por mais novos ou mais vendidos.
• A ficha traz o vendedor do buy box, não a lista de todos os vendedores de um produto. No Brasil, a ficha às vezes vem sem a distribuição de estrelas.
• Só dados públicos: nenhum dado de contato de compradores ou vendedores.

Quanto custa

Busca, produto e perguntas custam 2 créditos; avaliações, 1. No plano Growth anual (US$ 2 por 1.000 créditos), uma página de busca custa US$ 0,004 e uma ficha de produto também. Acompanhar 100 produtos por dia pela ficha são 200 créditos por dia, cerca de 6.000 por mês: US$ 12 nessa tarifa, dentro do menor plano, de US$ 30 por mês com 7.000 créditos. Veja os preços.

Comece

1. Crie sua conta e teste a API do Mercado Livre grátis: 50 créditos, sem cartão.
2. Copie a API key do dashboard e rode a busca do passo 1 com o seu produto.
3. Guarde item_id e product_id das linhas que interessam e use-os na ficha, nas avaliações e nas perguntas.
4. Agende as chamadas e salve cada resposta com a data para acompanhar preço, vendas e avaliações.

A página da API do Mercado Livre tem um teste ao vivo sem cadastro. Se você está comparando fornecedores, leia as melhores APIs de scraper do Mercado Livre. A mesma key também atende a API da Amazon, com a Amazon Brasil.