Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Última atualização em 05/05/2026
Promoções / Precificação
Por que as porcentagens ou valores retornados pela API de campanhas ou price_to_win podem diferir do que o front do site exibe?
O frontend pode aplicar decorações em tempo real ou recálculos de apresentação, enquanto a API retorna os valores como estão no motor no momento da consulta; por isso podem existir discrepâncias entre ambos.
Recomendação
Utilize os dados da API para decisões programáticas e considere que o front pode ajustar valores para apresentação; valide com exemplos reais se precisar de correspondência exata.
Se uma oferta aparece como "candidate" na API mas está ativa no front, o que pode estar acontecendo?
Algumas campanhas e processos são assíncronos; uma oferta pode estar como candidate na API até que a ativação seja concluída, enquanto o front pode exibir o estado publicado por regras de visualização ou por processamento recente.
Recomendação
Verifique as datas de start_date/end_date e o estado da campanha; considere que certos tipos de campanha requerem processamento final para aparecer como started na API.
price_to_win indica que "ganhamos" mas o front exibe outro vendedor em destaque; o que causa a diferença?
O motor price_to_win avalia condições no instante da consulta, enquanto o front pode aplicar recálculos por geolocalização, disponibilidade Full/SameDay ou janelas horárias que alteram o vendedor destacado; por isso o estado pode diferir entre API e front.
Recomendação
Revise a configuração de zonas e parâmetros logísticos; considere que a visualização front pode incorporar regras adicionais em tempo real.