Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 05/05/2026
FAQs Rate limit / Erro 429

Rate limit / Erro 429 e solicitações de aumento de RL


O que devo fazer quando a API retorna 429 Too Many Requests?

429 indica excesso de requisições em um curto período. Implemente backoff e retries (pausas com jitter), distribua as requisições (evite picos), consuma o scroll completamente antes de expirar e valide que não haja retries massivos. Para operações em massa, use batching prudente e evite concorrência extrema.

Recomendação
Aplique backoff exponencial com jitter, reduza a concorrência e consolide chamadas para minimizar a probabilidade de 429.
A API de visitas ou de diagnóstico de imagens suporta multiget grande ou requisições em massa sem provocar 429?

Muitas APIs não suportam multiget amplo; por exemplo, items/visits aceita apenas um product_id por consulta. Se for necessário reduzir chamadas, projete batching, use intervalos e limite o RPM; para diagnóstico de imagens não há multiget oficial, portanto limite o ritmo e considere requisições em massa somente se o endpoint suportar.

Recomendação
Respeite as limitações de cada endpoint, implemente batching controlado e espaçe as requisições quando o endpoint não suportar multiget.
O rate limit é aplicado por IP, por Client ID ou por usuário?

O controle principal é aplicado por Client ID (aplicação) na maioria dos casos e por endpoint; o tamanho do payload não é considerado no cálculo do limite. É recomendável distribuir o consumo da aplicação e solicitar aumento de cota em casos de volume legítimo pelos canais correspondentes.

Recomendação
Monitore o consumo por Client ID e solicite aumentos de cota com evidência de uso se precisar de maior RPM.
Por que recebo 429 ao usar scroll_id em buscas e como evitá-lo?

O scroll expira (tempo limitado) e o consumo repetido ou deixado aberto por muito tempo gera 429 (sobre cota). Consuma as páginas do scroll dentro do tempo de validade, reduza a concorrência e adicione backoff e retries com jitter para evitar picos.

Recomendação
Processe o scroll de forma contínua dentro do tempo de vida e reduza chamadas concorrentes para evitar expirações e 429.
Posso combinar offset/limit com scroll_id na mesma requisição?

Não. Usar scroll_id junto com offset/limit ou parâmetros incompatíveis causará erros. Utilize o método de paginação adequado para cada endpoint e respeite o mecanismo escolhido (scroll ou offset).

Recomendação
Não misture mecanismos de paginação; escolha scroll ou offset de acordo com a API e ajuste sua implementação em consequência.
Existe forma de solicitar aumento de RPM para endpoints de estoque?

Para necessidades de alto volume, entre em contato com a equipe de integrações comerciais com evidência de uso; enquanto isso, otimize chamadas (batching, consolidação por user_product) para reduzir RPM e evitar bloqueios.

Recomendação
Otimize chamadas e consolide operações por user_product enquanto gerencia a solicitação de aumento de cota com a equipe comercial.