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 Imagens e moderações

Imagens e moderações


Por que algumas imagens retornam erro 403 ou ficam "pendentes" na API ao publicar?

Um 403 geralmente indica que o servidor que hospeda a imagem bloqueia o acesso (firewall, whitelist de IPs) ou que a URL não é acessível para a plataforma; além disso, em publicações associadas ao catálogo as imagens podem ser gerenciadas pelo catálogo e não ser modificáveis via API.

Recomendação
Garanta que as URLs das imagens sejam acessíveis publicamente pela plataforma e que o host permita os IPs necessários; se a imagem pertencer ao catálogo, revise a gestão do catálogo.
A API suporta imagens no formato WebP ou devo usar JPG/PNG?

O sistema processa múltiplos formatos (JPG, PNG, WebP, GIF). O Mercado Livre pode otimizar e servir imagens em WebP, portanto a aparição de .webp no array de pictures é esperada e não requer alteração na integração.

Recomendação
Você pode enviar JPG/PNG normalmente; o sistema pode converter ou servir WebP internamente, portanto não é necessário substituir os formatos atuais.
Como evitar 429 ao usar o endpoint de diagnóstico de imagens?

Evite picos de chamadas e distribua as requisições; não há um modo massivo público em todos os casos, portanto é preciso gerenciar rate limits com backoff exponencial, batching e otimização de requisições para não saturar o endpoint.

Recomendação
Agrupe diagnósticos em lotes quando possível, espaçe as chamadas e aplique backoff com jitter para minimizar 429.