Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.Documentação do
Última atualização em 13/03/2024
Moderações de imagens
Fluxo recomendado
- Valide o fluxo de carregar imagens dos itens. É importante usar o endpoint https://api.mercadolibre.com/pictures/items/upload que te permite subir imagens e validar sua qualidade.
- Certifique-se de que as imagens não contenham infrações e sejam depois sejam moderadas, use o endpoint https://api.mercadolibre.com/moderations/infractions/USER_ID?related_item_id=ITEM_ID
- Identifique os picture_ids internos afetados para reativar os anúncios.
Consultar itens com moderação de imagens
Para obter os itens com moderação de imagens, devemos filtrar aqueles itens ativos e com tag poor_quality_thumbnail.
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/288230145/items/search?status=active&tags=poor_quality_thumbnail
Resposta:
{
"seller_id": "288230145",
"results": [
"MLA1352323391",
"MLA1352071928"
],
"paging": {…},
"query": null,
"orders": [...],
"available_orders": [...]
}
Consultar moderação de imagem
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/453616000?related_item_id=MLA1259572000
Resposta:
{
"infractions": [
{
"id": "1083677517",
"date_created": "2022-12-21T10:26:46.769-0400",
"user_id": "453616333",
"related_item_id": "MLA1259572000",
"element_id": "MLA1259572000",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "PQT",
"reason": "Tu foto de portada no tiene fondo blanco puro. Corregila para recuperar exposición.",
"remedy": "Para recuperar tu exposición, corrige el fondo de tu foto de portada
El fondo de tu foto debe ser blanco puro, ¡no uses texturas o elementos de fondo!"
}
],
"paging": {
"offset": 0,
"limit": 20,
"total": 1
},
"sorting_type": "date_created_desc"
}
Consulte imagens internas com moderações
Identifique imagens internas de um produto que tenham moderações associadas, como tamanho mínimo, conteúdo fora do produto e marca d'água.
Resposta:
{
"infractions": [
{
"id": "1914212309",
"date_created": "2024-02-19T15:30:44.143-0400",
"user_id": "497725790",
"related_item_id": "MLB3600679037",
"element_id": "MLB3600679037",
"element_type": "ITM",
"site_id": "MLB",
"filter_subgroup": "FOTOS",
"reason": "Você tem fotos que não correspondem ao produto. Exclua essas imagens para voltar a vender no Mercado Livre.",
"remedy": "Você tem fotos para corrigir. Exclua as fotos que não correspondem ao produto para reativar seu anúncio e continuar vendendo no Mercado Livre.",
"pictures": [
{
"variation_id": 0,
"picture_ids": [
"745606-MLB51269121000_082022"
]
}
]
}
],
"paging": {
"offset": 0,
"limit": 20,
"total": 1
},
"sorting_type": "date_created_desc"
}
Saiba mais sobre como trabalhar com imagens.