Moderações

O recurso /infractions retorna as informações relevantes relacionadas às infrações detectadas em algum dos elementos publicados (itens, perguntas, respostas e opinião sobre o produto). Saiba mais sobre das Políticas para Cadastramento de Produtos no Mercado Livre (Argentina, Brasil, México, Chile, Colômbia e Uruguai).

Conteúdos

→Consultar moderações
→Consultar moderações com filtro
    ↳Filtros disponíveis
→Qualidade de imagens
    ↳Como identificar erros
    ↳Descrição de parâmetros
    ↳Possíveis IDs de Condições
    ↳Gerenciamento de erros
→Adicionar tag poor_quality_thumbnail em item de teste

Consultar moderações

Importante:
Esta nova versão estará disponível a partir de 1º de dezembro de 2020. Retornará mais informações e você poderá filtrar melhor as consultas.

Através do GET você pode verificar os elementos afetados por algum tipo de moderação incluindo:

  • ítens
  • perguntas ou respostas (questions)
  • opinião do produto (review)

Você também poderá saber o motivo (reason) e solução (remedy) para solicitar em espanhol/português (segundo o site onde se aplica a infração) ou em inglês.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678

Resposta:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       },
       {
           "id": "594651285",
           "date_created": "2020-10-27T22:46:17.631-0400",
           "user_id": "12345678",
           "related_item_id": "MLA1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 2,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Campos da resposta

id: identificador único da infração.
date_created: data em que a infração ocorreu.
user_id: o usuário que cometeu a infração.
related_item_id: Identificador único da publicação relacionada ao item que possui a infração. Se for em uma publicação, o valor deste atributo será igual ao valor do atributo element_id.
element_id: Identificador único do item que possui a infração. Segundo o atributo element_type.
element_type: tipo de elemento, os valores podem ser: ITM (publicação), QUE (perguntas e respostas) e REV (reviews/opinião sobre o produto).
site_id: site no mercado do item com a infração.
reason: texto (html) que descreve o motivo e a política que foi violada.
remedy: texto (html) indica a ação, apenas nos casos em que é recuperável. Por exemplo, "Remover dados pessoais de uma publicação".


Notas:
- Em 1 de dezembro apagaremos os campos current_status e sub_status da resposta, para obter o status atual do item você deve consultar o recurso /items.
- Considere que a API /moderations/infractions/ listará os itens com status final (forbidden) ou temporário (waiting_for_patch, held, pending_documentation), mas não trará itens que foram baixados por duplicidade. Se você deseja verificar se um usuário está suspenso, pode verificar o status => list => allow através dos usuários (https://api.mercadolibre.com/users/$USER_ID). Se esse campo for false, significa que está suspenso.
Importante:
Caso o usuário se encontre suspenso, sempre recomendamos a que busque o portal de contato ou em alguns caso ao tentar logar-se retornará um ponto de contato.


Consultar moderações com filtro

Filtros disponíveis

Filtro Descrição Opções Por padrão
related_item_id ID da publicação associada à infração - -
element_id Id do elemento moderado - -
element_type Tipo de elemento moderado ITM (item)
REV (review)
QUE (pergunta/resposta)
-
date_created_since Data de início da filtragem Formato: YYYY-MM-DD -
date_created_to Data de término da filtragem Formato: YYYY-MM-DD -
language Você pode solicitar os textos de reason e remedy em inglês, além do idioma padrão do país onde o elemento é publicado EN Idioma oficial do país onde o elemento moderado é publicado, português (para o Brasil) e espanhol (para hispânicos)
limit Número de infrações devolvidas O valor é de 1 até 20 20
offset Offset para o paginado 0
sort Classifique os resultados por data de criação crescente ou decrescente date_created_asc, date_created_desc date_created_desc

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=X

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0

Resposta:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA169211231",
           "element_id": "MLA169211232",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Qualidade de imagens

O recurso /quality/picture permitirá a você identificar quais erros as imagens desses itens que possuem a tag poor_quality_thumbnail possuem, ou seja, foram validadas pelo Mercado Livre e não atendem a nenhum requisito de imagem. Assim, você poderá identificar as publicações com imagens de baixa qualidade e, conseqüentemente, moderadas, causando perda de exposição nas buscas.
Saiba mais sobre o recurso Busca de itens e a importância das fotos para os vendedores.


Como identificar erros

Para identificar se há itens com erros, realize a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/quality/pictures/$ITEM_ID

Resposta:

{
    "itemID": "MLA0111111",
    "quality": "good",
    "thumbnail": "344725-MLA25503040734_042017",
    "conditions": [
        {
            "id": "white_background",
            "passed": true
        },
        {
            "id": "minimum_size",
            "passed": true
        },
        {
            "id": "logo_text_watermark",
            "passed": true
        },
        {
            "id": "unprofessional_photo",
            "passed": true
        }
    ],
    "taggedDate": "2019-05-02T07:27:40Z"
}

Descrição de parâmetros

itemID: ID do anúncio.
quality: qualidade de imagem, você pode tomar os valores “good” ou “poor”, definindo os status de “imagem boa” ou “imagem ruim” respectivamente.
thumbnail: é a imagem pela qual o item foi processado, corresponde ao thumbnail do item.
conditions: são um conjunto de condições pelas quais um item atravessa para determinar sua qualidade de imagem. Uma condição é composta por sua ID (dando uma definição breve do que analisa) e seu atributo de passed, valor booleano definindo se a imagem atendeu ou não à condição.
taggedDate: data do último processamento realizado sobre o item.


Possíveis IDs de Condições

minimum_size: Esta validação avalia se alguma das imagens da publicação superam o mínimo de 500 x 500 px.
logo_text_watermark: Esta validação avalia se a primeira imagem da publicação contém logos, texto, banners promocionais ou marcas d'água.
white_background: Essa validação avalia se a primeira imagem da publicação tem fundo branco puro. Ou seja, um fundo branco criado com um editor de imagens, ao invés de uma foto do produto em frente a uma parede ou outro elemento.
multiproduct: Avalia se a primeira imagem contém mais de um produto. Por exemplo, não permitimos que a primeira imagem da publicação tenha vários pares de sapatilha.
blur: avalia se as imagens da publicação não estejam borradas.
unprofessional_photo: ocorre quanto o resto das validações da negativo e avalia três condições: mais de um produto, fundo branco e logos. Não significa que a imagem cumpra as três, mas que pode não estar cumprindo uma delas.
rollbacked: esta validação é reservada a equipe de atenção ao cliente. Utilizada quando o vendedor se contacta para reclamar de detecções incorretas (falso positivo). Uma vez aplicada, a foto não será moderada, exceto que o vendedor altere a imagem.


Gerenciamento de erros

Estrutura do erro

{
"error": Error Type,
"code": Error code,
"message": error message,
"cause": list of error cause
}

Exemplo invalid access_token

{
  "message": "access_token is missing",
  "error": "Forbidden",
  "status": 403,
  "cause": "Couldn't validate authentication"
}

Exemplo item sem validar

{
 "message": "No picture tagged for item (Item_id)",
 "error": "Not Found",
 "status": 404,
 "cause": "Element not found"
}

Para consultar quais ações deve realizar caso a imagem principal do seu anúncio não atenda a alguma validação, você pode utilizar o seguinte recurso:

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/tagging/quality/message/$ITEM_ID

Resposta:

{
  "reason": "Para recuperar tu exposición, corregí tus fotos
  • Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom.
", "conditions": [ { "id": "sizePictures", "message": "Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom." } ] }
Nota:
Quando você corrige a imagem de uma publicação que foi moderada, as validações serão realizadas novamente e, se forem positivas, a tag será removida e recuperará sua exposição original.

Veja mais sobre trabalhar com imagens.


Adicionar tag poor_quality_thumbnail em item de teste

Para adicionar a tag poor_quality_thumbnail em um item de teste, carregue os dados do seu usuário de teste no formulário.


ou registre-se para receber as últimas notícias sobre nossa API