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.
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.
// escolha_da_integracao
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
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
Troque a URL ou keyword e mantenha sua chave apenas no servidor. Nunca exponha a credencial em JavaScript enviado ao navegador.
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
}' 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"]) 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
Exemplo reduzido a partir do contrato publicado. IDs e valores são ilustrativos; confira o schema completo antes de tipar sua integração.
{
"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
// workflow_recomendado
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.
Rode PLP para as keywords prioritárias e descubra produtos, preços e sellers presentes na busca.
Normalize e deduplique por URL, SKU e seller antes de escolher quais itens merecem aprofundamento.
Consulte PDP nos produtos estratégicos para obter estoque, atributos, seller, frete e ofertas alternativas.
Consulte reviews separadamente quando opinião, nota e evolução de avaliações fizerem parte da análise.
Salve snapshots imutáveis com executionId e horário da coleta; a GeckoAPI não cria seu histórico automaticamente.
Compare snapshots e envie mudanças relevantes para BI, alerta, CRM ou workflow operacional.
// limites_e_operacao
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. |
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.
// continue_a_implementacao
Página de caso de uso para pricing, sellers, estoque e alertas.
Guia de snapshots, deduplicação, alertas e modelagem para BI.
Quando construir coleta própria e quais custos operacionais considerar.
Como conectar agentes a dados atuais sem colocar a chave no cliente.
Introdução prática à autenticação, primeira chamada e resposta.
Workflow seller-first com validação de site e enriquecimento empresarial.
// fontes_e_verificacao
Última verificação desta página: .
Referência oficial para aplicação, OAuth 2.0 e recursos privados autorizados.
Referência oficial para recursos de itens, sellers, filtros e resultados de busca.
// perguntas_frequentes
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.
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.
Sim. O endpoint PLP aceita keyword e monta a busca; também aceita uma URL pública de listagem. PDP e reviews exigem URL.
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.
Não. Cada chamada produz um snapshot atual. Seu sistema deve armazenar execuções e comparar os registros para formar séries e alertas.
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.
O custo é informado na documentação de cada endpoint. A maioria consome 1 crédito, mas endpoints especializados podem consumir mais.
// para_quem_serve
Acompanhe anúncios, variações, preço atual e disponibilidade por produto.
Enriqueça seu cadastro com nome, atributos, fotos, variações e descrição.
Gere insumos para dashboards, relatórios e tomada de decisão.
Seu agente responde perguntas sobre produtos e anúncios com dados reais.
Integre com fluxos automatizados: alertas, sync, ETL.
Compare vendedores, reputação, categorias e disponibilidade em escala.
// como_funciona
Acesse o dashboard e gere sua chave de API.
POST /v1/extract com a URL, target e tipo no body.
Dados estruturados, padronizados e prontos para uso.
// integracao_ia
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
Crie sua conta e comece grátis. Sem cartão necessário.