5 formas de exportar dados do Mercado Livre (e qual é a melhor)

O dilema da exportação de dados do Mercado Livre

Todo vendedor do Mercado Livre chega a um ponto em que os relatórios nativos da plataforma não são suficientes. Você quer cruzar vendas com custos de publicidade, calcular margem real considerando ICMS e comissões, ou simplesmente ter todos os dados do mês em uma planilha para enviar ao contador.

O problema é que o Mercado Livre não foi feito para ser uma ferramenta de análise. Ele é uma plataforma de vendas. A análise fica por sua conta --- e para fazer isso, você precisa exportar dados.

Neste artigo, vamos comparar cinco formas de tirar seus dados de dentro do Mercado Livre e levá-los para onde eles realmente podem ser úteis.

Método 1: Exportação CSV pelo Seller Central

Como funciona

O Mercado Livre permite exportar relatórios de vendas em formato CSV direto do painel do vendedor. Você acessa a seção de vendas, seleciona o período desejado, e baixa o arquivo.

O que vem no arquivo

O CSV de vendas inclui informações básicas de cada pedido: número do pedido, data, produto, quantidade, preço, status do envio e dados do comprador. Para vendedores brasileiros, geralmente inclui também o número da nota fiscal quando disponível.

Limitações

• Dados financeiros aproximados: o CSV usa os valores da API de pedidos, que são aproximações. A comissão real (CVFV + CVFF), o custo de envio com Full ou Correios, e as retenções de ICMS não aparecem com precisão
• Sem dados de publicidade: impressões, cliques, ACOS e ROAS ficam em outra seção e não são exportáveis por CSV
• Sem dados de qualidade: score de qualidade dos anúncios, qualidade de imagem e posição nos mais vendidos não estão disponíveis
• Processo manual: precisa repetir toda vez que quiser dados atualizados
• Período limitado: dependendo da quantidade de pedidos, o período disponível pode ser restrito

Para quem serve

Vendedores com poucos pedidos por mês que precisam apenas de um controle básico ou enviar uma lista de vendas para o contador.

Método 2: API do Mercado Livre com código próprio

Como funciona

A API do Mercado Livre oferece acesso programático a praticamente todos os dados da plataforma. Você pode consultar pedidos, anúncios, envios, faturamento, publicidade, categorias e muito mais.

O que é possível

Com a API, você pode construir exatamente o que precisa. Quer um relatório que cruza vendas com custos de publicidade por SKU? É possível. Quer monitorar o estoque de 500 anúncios e receber alerta quando cair abaixo de 10 unidades? Também é possível.

Os endpoints mais usados para exportação de dados:

• /orders/search --- pedidos com paginação
• /items/{id} --- dados de cada anúncio
• /billing/integration/group/ML/order/details --- faturamento real (comissões, envio, retenções)
• /advertising/advertisers/{id}/campaigns --- campanhas de publicidade
• /users/{id}/shipping_preferences --- preferências de envio e Mercado Envios Full

Limitações

• Complexidade técnica: autenticação OAuth2, refresh de tokens, paginação, rate limits
• Custo de manutenção: a API muda com frequência, e cada mudança pode quebrar seus scripts
• Infraestrutura: você precisa de um servidor ou serviço para rodar os scripts periodicamente
• Tempo de desenvolvimento: construir algo robusto leva semanas ou meses

Para quem serve

Empresas com equipe técnica dedicada ou vendedores que são desenvolvedores.

Método 3: Ferramentas de automação (Zapier, Make)

Como funciona

Ferramentas como Zapier ou Make (antigo Integromat) permitem criar automações entre serviços sem programar. Você pode, em teoria, conectar o Mercado Livre ao Google Sheets e criar fluxos automáticos.

O que é possível

Essas ferramentas funcionam bem para automações simples: quando uma venda acontece, adicionar uma linha na planilha. Ou quando o status de um envio muda, atualizar uma célula.

Limitações

• Integração limitada com Mercado Livre: a maioria dessas ferramentas não tem integração oficial com o Mercado Livre. Você precisa usar webhooks genéricos ou conectores de terceiros
• Dados superficiais: mesmo quando funciona, os dados disponíveis são básicos --- sem faturamento real, sem métricas de publicidade, sem qualidade de anúncios
• Custo por execução: cada execução de um "zap" consome créditos. Com centenas de pedidos por mês, o custo pode ser alto
• Fragilidade: automações sem código tendem a quebrar silenciosamente quando algo muda na API ou no formato dos dados
• Sem fórmulas: você não tem acesso a consultas em tempo real dentro das células

Para quem serve

Vendedores que precisam de uma automação pontual e específica, e que já usam essas ferramentas para outras integrações.

Método 4: Google Apps Script personalizado

Como funciona

O Google Apps Script é a linguagem de programação embutida no Google Sheets. Você pode escrever scripts que chamam a API do Mercado Livre e preenchem a planilha automaticamente.

O que é possível

Como o script roda dentro do próprio Google Sheets, os dados vão direto para as células. Você pode criar gatilhos de tempo (executar a cada hora, por exemplo) e formatar os dados como quiser.

Limitações

• Limite de execução de 6 minutos: scripts do Apps Script têm um timeout de 6 minutos. Com muitos pedidos, você precisa implementar paginação com continuação, o que complica bastante o código
• Cota de chamadas HTTP: o Apps Script limita o número de chamadas UrlFetchApp por dia
• Gerenciamento de tokens: você precisa implementar o fluxo OAuth2 e o refresh automático de tokens dentro do Apps Script
• Sem suporte a URLSearchParams: o runtime do Apps Script não tem URLSearchParams, então você precisa construir query strings manualmente
• Manutenção contínua: cada mudança na API do Mercado Livre exige atualização manual do script

Para quem serve

Vendedores com conhecimento de JavaScript/Apps Script que querem total controle sobre o processo, e que aceitam o custo de manutenção.

Método 5: Jaguar Sheet --- complemento para Google Sheets

Como funciona

O Jaguar Sheet é um complemento para Google Sheets que automatiza a exportação e sincronização de dados do Mercado Livre. Ele se instala direto do Google Workspace Marketplace e funciona dentro da planilha, sem precisar de configuração técnica.

O que é possível

O Jaguar Sheet cria até cinco planilhas sincronizadas automaticamente:

1. Vendas: 43 colunas por pedido, incluindo dados reais de faturamento da API de billing (comissão CVFV + CVFF, custo de envio com Full e Correios, financiamento, bonificações, retenções de ICMS e nota fiscal)
2. Anúncios: 40 colunas com estoque (incluindo Full), preços promocionais, visitas, qualidade de imagem, posição nos mais vendidos e status no catálogo
3. Promoções: todos os descontos ativos com porcentagens, prazos e contribuição do Mercado Livre
4. Campanhas publicitárias: métricas por campanha (ACOS, ROAS, CTR, CPC) com janela configurável
5. Anúncios publicitários: desempenho individual de cada anúncio dentro das campanhas

Além das planilhas sincronizadas, o Jaguar Sheet oferece ferramentas de inteligência de mercado no painel lateral:

• Categorias e mais vendidos: navegue pela árvore de categorias e veja os 20 mais vendidos de cada uma, com opção de inserir na planilha
• Tendências: veja as palavras-chave em alta por site e por categoria, com opção de inserir na planilha
• Relatórios de faturamento: selecione qualquer período e insira o resumo de faturamento oficial diretamente na planilha
• Tempo de resposta: métricas de resposta a perguntas, com opção de inserir na planilha

Dados financeiros reais

Este é um diferencial importante. Enquanto o CSV e a maioria das soluções usam os dados aproximados da API de pedidos, o Jaguar Sheet usa a API de faturamento do Mercado Livre. Isso significa que as comissões, custos de envio e retenções são os mesmos valores que aparecem no seu resumo de faturamento.

Para vendedores brasileiros, isso é especialmente relevante porque:

• As retenções de ICMS aparecem detalhadas por pedido
• O custo de envio com Mercado Envios Full é separado do cross-docking
• A comissão fixa (CVFF) aparece, o que não acontece na API de pedidos padrão
• O número da nota fiscal é incluído quando disponível

Limitações

• Precisa de assinatura após os 14 dias de teste gratuito
• Funciona apenas dentro do Google Sheets (não Excel, não Notion)
• Atualização a cada hora (não em tempo real)

Para quem serve

Vendedores que querem dados completos e atualizados sem esforço técnico, e que já usam Google Sheets no dia a dia.

Tabela comparativa

Critério	CSV Manual	API Própria	Zapier/Make	Apps Script	Jaguar Sheet
Facilidade de uso	Alta	Baixa	Média	Baixa	Alta
Dados financeiros reais	Não	Sim	Não	Sim	Sim
Dados de publicidade	Não	Sim	Parcial	Sim	Sim
Atualização automática	Não	Sim	Sim	Sim	Sim
Custo de manutenção	Nenhum	Alto	Médio	Alto	Nenhum
Ferramentas de inteligência	Não	Não	Não	Possível	Sim
Tempo para configurar	2 min	Semanas	Horas	Dias	2 min
ICMS e retenções	Não	Sim	Não	Possível	Sim

Como escolher o método certo

Se você está começando

Comece com o CSV manual. É gratuito e dá para ter uma noção básica dos seus números. Quando perceber que está gastando tempo demais repetindo o processo, migre para algo automático.

Se você tem equipe técnica

A API própria dá total controle, mas exige investimento contínuo. Avalie se o custo de manter a integração compensa versus usar uma solução pronta.

Se você quer praticidade sem código

O Jaguar Sheet é a opção mais direta. Instala, conecta, ativa. Os dados aparecem na planilha e se atualizam sozinhos. As ferramentas do painel lateral (categorias, tendências, faturamento) permitem inserir dados adicionais diretamente na planilha.

Se você precisa de dados para a contabilidade

Independente do método, certifique-se de que a solução traz dados financeiros reais (da API de faturamento, não da API de pedidos). A diferença entre a comissão aproximada e a real pode ser significativa, especialmente quando inclui a taxa fixa CVFF e as retenções de ICMS.

Dicas para exportação eficiente

1. Defina o que você realmente precisa

Antes de exportar tudo, pergunte: quais decisões vou tomar com esses dados? Se é calcular margem, você precisa de vendas + comissões + envio + retenções. Se é otimizar publicidade, precisa de ACOS por produto. Exportar só o que importa evita ruído.

2. Padronize o formato

Se vai usar os dados em uma planilha, defina um formato padrão e mantenha. Colunas fixas, nomes consistentes, mesma formatação de moeda. Isso evita retrabalho toda vez que atualizar os dados.

3. Automatize desde o início

Mesmo que pareça "bom o suficiente" exportar manualmente hoje, automatize. O volume de vendas tende a crescer, e o custo de migrar depois é maior do que começar certo.

4. Considere o Mercado Envios Full

Se você usa ou planeja usar o Mercado Envios Full, certifique-se de que sua solução de exportação traz o estoque correto (incluindo o que está nos centros de distribuição) e os custos de fulfillment separados.

Conclusão

Não existe um método perfeito para todos. Mas para a maioria dos vendedores brasileiros do Mercado Livre que usam Google Sheets no dia a dia, a combinação de planilhas sincronizadas automaticamente com fórmulas que consultam dados ao vivo oferece o melhor equilíbrio entre praticidade e profundidade de informação.

Teste Jaguar Sheet grátis por 14 dias e veja qual diferença faz ter todos os seus dados do Mercado Livre --- incluindo faturamento real, ICMS e custos de Full --- atualizados automaticamente na sua planilha. Instale pelo Google Workspace Marketplace.