Recursos Cross
Confira os principais recursos das nossas APIs
Documentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Moderações com pausado

Consultar moderações com item pausado
Realize uma busca de publicações com status: paused e a tag moderation_penalty. Para ativá-la, deve-se realizar um PUT em /items com status: active, pois esse tipo de moderação preventiva apenas pausa a publicação.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/users/0123456789/items/search?tags=moderation_penalty&status=paused
Resposta:
{
"seller_id": "0123456789",
"paging": {...},
"results": [
"MLA1147839589",
"MLA1148439168",
"MLA1149506534",
"MLA1157034561",
"MLA1164314507",
"MLA1173423437"
],
"orders": [...],
"available_orders": [...]
}
Quando identificar esses itens, você deve consultar suas moderações. Por exemplo:
Moderação por alteração incomum de preço
Chamada:
curl -L -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/moderations/last_moderation/$MODERATION_REFERENCE_ID
Exemplo:
curl -L -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/moderations/last_moderation/MLA926647862-ITM
Resposta:
[
{
"name": "PAUSED_PREVENTION_PRICE",
"date_created": "2022-10-25 15:57:46.0",
"wordings": [
{
"type": "REASON",
"value": "Pausamos porque detectamos uma alteração incomum no preço. Verifique o valor antes de reativá-la. Após isso, ficará ativa em alguns minutos."
},
{
"type": "REMEDY",
"value": "Inativa para revisão. Pausamos porque detectamos uma alteração incomum no preço. Verifique o valor antes de reativá-la. Após isso, ficará ativa em alguns minutos."
}
],
"evidence": [
{
"text_matched": "O preço alertado é 77393.720000",
"section_name": "item"
}
]
}
]
Nesse caso, recomendamos dar ao vendedor o acionável de corrigir o preço e ativar o item.
Moderação de item sem vendas
Itens sem vendas e/ou sem visitas também podem ser pausados pelo Mercado Livre para evitar impacto na reputação do vendedor.
Executando a mesma chamada anterior, obtemos informações sobre esse tipo de moderação.
Saiba mais sobre como gerenciar publicações sem vendas por um longo período.
Exemplo:
curl -L -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/moderations/last_moderation/MLA123444123-ITM
Resposta:
[
{
"name": "ABANDONED_ITEM_PERFORMANCE_WARNING",
"date_created": "2024-10-07 15:57:46.0",
"wordings": [
{
"type": "REASON",
"value": "Pausamos porque não teve vendas por um longo período. Fizemos isso para te ajudar com a gestão e evitar cancelamentos."
},
{
"type": "REMEDY",
"value": "Inativa para revisão. Se ainda quiser vender seu anúncio, revise para verificar se está atualizado e reative-o para que volte a ser publicado, ou exclua-o se não for mais vender."
}
],
"evidence": [
{
"text_matched": "Moderado por um processo interno do usecase: abandoned-item-performance e execução abandoned-item-performance_STANDARD",
"section_name": "item"
}
]
}
]
Nesse caso recomendamos dar o acionável ao vendedor para revisar o anúncio, verificar se está atualizado e reativá-lo para que volte à venda ou excluí-lo se não for mais vender.
Upload de imagens por URL
Ao criar um novo item e fazer upload de imagens via URLs (source), o Mercado Livre precisa baixar e validar as imagens antes de ativar a publicação. Durante esse processo, o status do item será:
1- Para publicações de Marketplace:
- status: "paused"
- sub_status: "picture_download_pending"
2- Para publicações de Imóveis e Veículos:
- Se o vendedor tem user_type = "normal":
- status: "paused"
- sub_status: "picture_download_pending"
- Se o vendedor tem user_type = "real_estate_agency" ou "car_dealer":
- status: "not_yet_active"
- sub_status: "picture_download_pending"
Ativação automática: Quando as imagens forem baixadas corretamente e cumprirem os requisitos, a publicação será ativada automaticamente com: status: "active"
Casos em que o item será moderado
Se as imagens:
- Não puderem ser baixadas dentro de um período determinado, ou
- Forem baixadas, mas não atenderem às dimensões mínimas requeridas,
então o item será moderado com:- status: "under_review"
- sub_status: "picture_download_pending"
Nos casos em que as imagens não puderem ser baixadas após um tempo definido, ou a imagem baixada estiver abaixo das dimensões mínimas esperadas, o item será moderado com status: “under_review” e sub_status: “picture_download_pending”.
Lembre-se: Uma imagem será válida desde que tenha no mínimo 250px em ambos os lados (largura e altura) e pelo menos um dos lados com mais de 500px.
Se a imagem não puder ser baixada após um tempo definido, o item será moderado com status: under_review, sub_status: picture_downloading_pending.
Resposta:
[
{
"name": "PICTURE_DOWNLOAD_PENDING",
"date_created": "2025-05-01 02:00:38.0",
"wordings": [
{
"type": "REMEDY",
"value": "A foto não foi carregada corretamente. Corrija para reativar sua publicação."
},
{
"type": "REASON",
"value": "A foto não foi carregada corretamente. Corrija para reativar sua publicação."
}
],
"evidence": [
{
"text_matched": "MLA2087670262",
"section_name": "item"
}
]
}
]
Nesse caso, recomendamos dar ao vendedor o acionável para carregar novamente a imagem de capa, pois ela não pôde ser processada (link de imagem inválido).
Próximo: Diagnóstico de imagens.