ML Mercadolivre.com.br

API Mercado Livre para Produtos, Preços e Sellers

A GeckoAPI transforma páginas públicas do Mercado Livre em JSON para consultar produtos, preços, estoque, sellers, buscas e avaliações. Ela serve para monitoramento, catálogo e inteligência de mercado; para operar anúncios, pedidos ou uma conta autorizada, use a API oficial do Mercado Livre.

GeckoAPI é uma API independente e não é afiliada, patrocinada ou endossada por Mercadolivre.com.br.

Não precisa de cartão de crédito.

API Mercado Livre produtos API Mercado Livre anúncios scraper Mercado Livre web scraping Mercado Livre dados Mercado Livre monitoramento Mercado Livre

// escolha_da_integracao

API oficial ou API de dados públicos?

A escolha depende do trabalho. Operação de conta e dados públicos são problemas diferentes; misturá-los costuma gerar escopo, autenticação e expectativas erradas.

O que é

Uma camada independente para transformar páginas públicas do Mercado Livre em JSON estruturado para catálogo, pricing, BI, monitoramento, pesquisa e agentes.

O que não é

Uma substituta da API oficial para publicar anúncios, ler pedidos, responder compradores ou executar ações privadas em nome de um seller.

Opção Use quando Autenticação Resultado principal Referência
API oficial do Mercado Livre Operar sua conta: publicar e editar anúncios, acessar pedidos e executar rotinas autorizadas do seller. Aplicação registrada, OAuth 2.0 e autorização do usuário. Recursos oficiais vinculados à conta e às permissões concedidas. Autenticação oficial
GeckoAPI Extract Consultar páginas públicas de produto, busca e avaliações para pricing, catálogo, BI e inteligência competitiva. Chave da GeckoAPI enviada pelo seu backend. PDP, PLP e reviews em JSON estruturado e documentado. Ver PDP
GeckoAPI Workflows Encadear descoberta, enriquecimento e histórico, como monitorar preços ou encontrar sellers empresariais. Chave da GeckoAPI e entrada do template escolhido. Execução assíncrona com artefato JSON ou CSV, conforme o workflow. Ver workflow

// cobertura_de_endpoints

Endpoints de Mercado Livre disponíveis

Cada linha leva à documentação canônica com entradas, schema e exemplo de resposta completos.

Endpoint Entrada Campos principais Paginação Créditos
Mercado Livre PDP URL pública de produto; CEP é opcional para consultar frete e prazo. Nome, preço, preço regular, estoque, seller, outros sellers, variações, atributos, avaliação e frete. Não se aplica: uma página de produto por chamada. Consulte o custo vigente na documentação do endpoint.
Mercado Livre PLP Keyword ou URL pública de listagem; aceita página e faixa de preço. Itens, preço, seller, localização, avaliação, total de resultados, página e próxima página. page começa em 1; nextPage informa a continuação quando disponível. Consulte o custo vigente na documentação do endpoint.
Mercado Livre Reviews URL pública de produto e página opcional. Nota, título, comentário, data, votos úteis, mídia, total de reviews e próxima página. page pode começar em 0; hasNextPage e nextPage orientam a sequência. Consulte o custo vigente na documentação do endpoint.

// exemplos_copiaveis

curl, Python e JavaScript

Troque a URL ou keyword e mantenha sua chave apenas no servidor. Nunca exponha a credencial em JavaScript enviado ao navegador.

curl · busca PLP
curl -X POST "https://api.geckoapi.com.br/v1/extract" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "mercadolivre.com.br",
    "type": "plp",
    "keyword": "notebook gamer",
    "page": 1
  }'
Python · produto PDP
import requests

response = requests.post(
    "https://api.geckoapi.com.br/v1/extract",
    headers={"Authorization": "Bearer SUA_CHAVE"},
    json={
        "target": "mercadolivre.com.br",
        "type": "pdp",
        "url": "https://produto.mercadolivre.com.br/MLB-123",
        "zipCode": "01001-000",
    },
    timeout=90,
)
response.raise_for_status()
product = response.json()["data"]
print(product["name"], product["price"])
JavaScript · avaliações
const response = await fetch(
  "https://api.geckoapi.com.br/v1/extract",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer SUA_CHAVE",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target: "mercadolivre.com.br",
      type: "review",
      url: "https://www.mercadolivre.com.br/p/MLB123",
      page: 0,
    }),
  },
);

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { data } = await response.json();
console.log(data.totalReviews, data.reviews);

// resposta_real_redigida

Como o JSON chega

Exemplo reduzido a partir do contrato publicado. IDs e valores são ilustrativos; confira o schema completo antes de tipar sua integração.

mercado-livre-response.json
{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "executionId": "11111111-2222-4222-8222-111111111111",
  "data": {
    "name": "Acrílico Toque de Seda Premium 16L",
    "sku": "MLB-4196330777",
    "price": 620.21,
    "regularPrice": 689,
    "currency": "BRL",
    "availability": "InStock",
    "stockQuantity": 7,
    "sellerName": "Loja Oficial RN",
    "sellerId": "1006734354",
    "sellerLevel": "5_green",
    "freeShipping": true,
    "shippingFee": 15.99,
    "aggregateRating": {
      "ratingValue": 4.8,
      "reviewCount": 125
    },
    "otherSellers": [
      {
        "sellerName": "Casa da Tinta",
        "price": 629.9,
        "sellerId": "123456"
      }
    ]
  }
}

// campos_essenciais

Definições dos campos

data.name / data.sku
Identificação normalizada do produto e código público encontrado na página.
data.price / data.regularPrice
Preço atual e preço regular quando ambos estão expostos; valores numéricos em BRL.
data.availability / data.stockQuantity
Sinal de disponibilidade e quantidade somente quando a origem a torna pública.
data.sellerName / data.sellerId
Identidade pública do seller principal associada ao anúncio.
data.otherSellers[]
Ofertas alternativas encontradas na PDP, com seller e preço quando disponíveis.
data.aggregateRating
Nota agregada, total de avaliações e melhor nota informados pela página.
data.shippingFee
Frete em BRL para o CEP aplicado; pode ser 0, um valor ou null quando não exposto.
requestId / executionId
Identificadores para suporte, rastreio de execução e deduplicação no seu pipeline.

// workflow_recomendado

PLP descobre; PDP aprofunda

Para monitoramento competitivo, use a listagem como radar e a página de produto como ficha técnica. Acrescente reviews somente quando opinião e reputação fizerem parte da decisão.

  1. 01

    Rode PLP para as keywords prioritárias e descubra produtos, preços e sellers presentes na busca.

  2. 02

    Normalize e deduplique por URL, SKU e seller antes de escolher quais itens merecem aprofundamento.

  3. 03

    Consulte PDP nos produtos estratégicos para obter estoque, atributos, seller, frete e ofertas alternativas.

  4. 04

    Consulte reviews separadamente quando opinião, nota e evolução de avaliações fizerem parte da análise.

  5. 05

    Salve snapshots imutáveis com executionId e horário da coleta; a GeckoAPI não cria seu histórico automaticamente.

  6. 06

    Compare snapshots e envie mudanças relevantes para BI, alerta, CRM ou workflow operacional.

// limites_e_operacao

O que planejar antes de produção

O contrato documentado é a fonte de verdade. Campos públicos podem não existir em todos os itens, e a página de origem pode mudar entre duas coletas.

Tema Comportamento Como tratar
Autenticação A GeckoAPI aceita uma chave no header de autorização. Faça a chamada no backend ou em uma função server-side; nunca publique a chave no navegador ou repositório.
Atualidade Cada chamada observa o conteúdo público disponível naquele momento. Salve o horário da sua coleta e defina frequência compatível com a decisão que será tomada.
Paginação PLP começa em 1; reviews podem começar em 0. A resposta informa a continuação. Pare quando não houver próxima página e deduplique itens repetidos entre páginas.
Campos opcionais Estoque, frete, outros sellers, atributos ou avaliações podem não ser expostos. Modele campos como opcionais e diferencie null, lista vazia e entidade não encontrada.
Entidade ausente Uma entidade não encontrada pode retornar notFound: true e data: null. Trate esse estado como resultado de negócio, não como JSON inválido.
Retries Falhas transitórias de rede ou origem podem acontecer; erros 4xx indicam entrada ou autenticação. Use timeout, backoff com jitter e limite de tentativas; corrija 4xx antes de repetir.
Créditos O consumo varia por endpoint; a maioria custa 1 crédito e endpoints especializados podem custar mais. Confirme o custo na documentação vigente e meça consumo por rotina antes de ampliar o volume.

Uso responsável e independência

A GeckoAPI estrutura dados de páginas públicas e não é afiliada, patrocinada ou endossada por Mercado Livre. Use apenas dados necessários ao seu caso, proteja chaves e resultados, respeite contratos, políticas da plataforma, privacidade e a legislação aplicável. Esta página não é aconselhamento jurídico.

// perguntas_frequentes

Perguntas sobre a API de Mercado Livre

A GeckoAPI é a API oficial do Mercado Livre? +

Não. A GeckoAPI é independente e estrutura dados de páginas públicas. Para operar uma conta, anúncios ou pedidos autorizados, use a API oficial do Mercado Livre.

Qual endpoint usar para monitorar preços? +

Use PLP para descobrir ofertas por keyword e PDP para aprofundar preço, estoque, seller, frete e outros sellers. Salve snapshots no seu banco para construir o histórico.

É possível buscar produtos sem informar uma URL? +

Sim. O endpoint PLP aceita keyword e monta a busca; também aceita uma URL pública de listagem. PDP e reviews exigem URL.

A resposta inclui sellers e reputação? +

PDP pode retornar seller principal, sellerId, nível, tipo e outros sellers. PLP retorna os sinais públicos presentes na listagem. Campos ausentes devem ser tratados como opcionais.

A API cria histórico de preços automaticamente? +

Não. Cada chamada produz um snapshot atual. Seu sistema deve armazenar execuções e comparar os registros para formar séries e alertas.

Como consultar avaliações do Mercado Livre? +

Use o endpoint Review com a URL pública do produto. A paginação pode começar em 0, e a resposta indica total, hasNextPage e nextPage.

Quanto custa cada chamada? +

O custo é informado na documentação de cada endpoint. A maioria consome 1 crédito, mas endpoints especializados podem consumir mais.

// para_quem_serve

Para quem serve

Monitoramento de preços

Acompanhe anúncios, variações, preço atual e disponibilidade por produto.

Catálogo e produto

Enriqueça seu cadastro com nome, atributos, fotos, variações e descrição.

Business Intelligence

Gere insumos para dashboards, relatórios e tomada de decisão.

Chatbots e IA

Seu agente responde perguntas sobre produtos e anúncios com dados reais.

Automação

Integre com fluxos automatizados: alertas, sync, ETL.

Sellers e concorrência

Compare vendedores, reputação, categorias e disponibilidade em escala.

// como_funciona

Como funciona

01

Crie sua conta

Acesse o dashboard e gere sua chave de API.

02

Chame a API

POST /v1/extract com a URL, target e tipo no body.

03

Receba JSON

Dados estruturados, padronizados e prontos para uso.

exemplo.sh
$ curl -X POST \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"url":"https://...","target":"mercadolivre.com.br","type":"pdp"}' \
https://api.geckoapi.com.br/v1/extract

// integracao_ia

Integre com IA (MCP)

Conecte agentes de IA à GeckoAPI e seu chatbot responde com dados reais de Mercadolivre.com.br.

// exemplos de perguntas que seu agente pode responder:

"Qual o preço atual desse produto no Mercado Livre?"

"Esse anúncio tem quais variações disponíveis?"

"Quem é o vendedor e qual a reputação?"

"Me mostre os atributos e especificações técnicas."

"Esse produto está disponível para envio?"

Fluxo: Chatbot → Agente MCP → GeckoAPI → Resposta com dados

100 créditos iniciais

Comece a usar a API de Mercadolivre.com.br

Crie sua conta e comece grátis. Sem cartão necessário.