Gerenciar Moderações

Para mayor información, consulta las políticas de publicación de Mercado Libre (Argentina, Brasil, México, Chile, Colombia y Uruguay).

Consultar moderações

Com o recurso /moderations/last_moderation você poderá gerenciar itens moderados a partir de notificações ou consultas ativas. Recomendamos identificar o motivo (reason) e a solução (remedy) e garantir ações para os vendedores conforme o tipo de moderação recebida.

Fluxo recomendado

Use este recurso para obter a última moderação aplicada a um item:

Chamada:

curl -L -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
'https://api.mercadolibre.com/moderations/last_moderation/$MODERATION_REFERENCE_ID'

Resposta:

[
  {
    "name": "POOR_QUALITY_THUMBNAIL",
    "id": "7123400815",
    "date_created": "2021-04-14T10:47:05.270-0400",
    "evidences": [
      {
        "text_matched": "604505-MLA82848669458_022025",
        "section_name": "pictures"
      },
      {
        "text_matched": "MLA29272",
        "section_name": "category"
      }
    ],
    "wordings": [
      {
        "type": "REMEDY",
        "value": "Corrija sua publicação para vender no Mercado Livre."
      },
      {
        "type": "REASON",
        "value": "Seu anúncio foi pausado porque, aparentemente, descumpre nossas Políticas de Cadastro de Anúncios."
      }
    ]
  }
]

Campos da resposta

• name: nome do filtro que gerou a moderação
• id: identificador único da moderação ativa. Uma vez que a moderação é resolvida, deixa de existir e não deve ser usado como referência persistente.
• date_created: data de criação da moderação. Formato: YYYY-MM-DD
• evidences: referência de onde a infração foi encontrada
  • text_matched: Valor ou texto específico que foi detectado como infração (por exemplo, um ID de imagem ou categoria).
  • section_name: Seção do conteúdo onde a infração foi identificada. Por exemplo: pictures, category.
• wordings: Mensagens explicativas associadas à moderação
  • type: REASON: motivo da infração | REMEDY: ação sugerida para corrigi-la
  • value: Texto da mensagem correspondente, dirigido ao usuário, explicando o motivo ou a ação a tomar.

Para publicações que tenham sido removidas e que não possam ser modificadas nem recuperadas devido a uma moderação, a resposta será:

[
  {
    "name": "DENYLIST",
    "id": "7123400816",
    "date_created": "2021-04-14T10:47:05.270-0400",
    "evidences": [
      {
        "section_name": "title",
        "text_matched": "Apple - Iphone-BDM-BDS"
      }
    ],
    "wordings": [
      {
        "type": "REASON",
        "value": "Seu anúncio foi cancelado porque a Apple confirmou a denúncia por falsificação."
      }
    ]
  }
]

Apenas será retornado o REASON, pois a moderação não tem um REMEDY.

Filtrar itens moderados de um usuário

Para consultar publicações com moderações ativas, você pode consultar aquelas com:

• status: under_review
• sub_status:
  • warning
  • waiting_for_patch
  • held
  • pending_documentation
  • forbidden
  • picture_downloading_pending

→ Filtrando por status=pending

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/users/$USER_ID/items/search?status=pending

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/users/123456/items/search?status=pending

Resposta:

{
  "seller_id": "123456",
  "query": null,
  "paging": {
    "limit": 50,
    "offset": 0,
    "total": 8
  },
  "results": [
    "MLC951993111",
    "MLC951803222",
    "MLC949619333",
    "MLC949664444",
    "MLC947745555",
    "MLC947725666",
    "MLC947725777",
    "MLC947699888"
  ],
  "orders": [...]
}

Uma vez que você tenha os itens que deseja consultar, pode fazê-lo diretamente sobre /last_moderations adicionando o sufixo.

Status, substatus e tags de moderações

Saiba mais sobre o fluxo e os estados das publicações.

Histórico de moderações

Com o recurso /infractions você acessa o histórico de infrações detectadas em itens, perguntas, respostas e avaliações de produtos.

Fluxo recomendado

Consultar histórico de infrações de um usuário

Com a consulta a seguir, você poderá ver as infrações com status final (forbidden) e aquelas com status temporário (waiting_for_patch, held, pending_documentation).

Tenha em mente que não são incluídos itens removidos por duplicidade.

Parâmetros de consulta:

• 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 (avaliação), QUE (pergunta/resposta).
• date_created_since: Data de início do filtro. Formato: YYYY-MM-DD
• date_created_to: Data de fim do filtro. Formato: YYYY-MM-DD
• language: Você pode solicitar os textos de reason e remedy em espanhol ou português. O idioma padrão é o inglês. ES (espanhol) ou PT (português).
• limit: Quantidade de infrações retornadas. O valor é de 1 a 20. Padrão 20.
• offset: Offset para paginação.
• sort: Ordenar os resultados por data de criação em ordem crescente ou decrescente. Exemplo: date_created_asc, date_created_desc.

Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&limit=2

Resposta:

{
  "infractions": [
    {
      "id": "1378710000",
      "date_created": "2023-09-11T10:37:45.107-0400",
      "user_id": "288230000",
      "related_item_id": "MLA135230000",
      "element_id": "MLA135200000",
      "element_type": "ITM",
      "site_id": "MLA",
      "filter_subgroup": "DESC",
      "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
      "remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos."
    },
    {
      "id": "1366077111",
      "date_created": "2023-09-03T13:02:14.109-0400",
      "user_id": "288230000",
      "related_item_id": "MLA138621111",
      "element_id": "MLA138621111",
      "element_type": "ITM",
      "site_id": "MLA",
      "filter_subgroup": "PQT",
      "reason": "Tu foto de portada no tiene fondo blanco puro. Corrígelo para reactivar tu publicación.",
      "remedy": "Tu foto de portada aún tiene problemas, corrígela para reactivar tu publicación. El fondo de esta foto debe ser blanco puro, no uses texturas o elementos de fondo!"
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 2,
    "total": 3
  },
  "sorting_type": "date_created_desc"
}

Parâmetros de 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: ID da publicação relacionada ao elemento com infração. Se a infração for em uma publicação, será igual ao campo element_id.
• element_id: Identificador do elemento com a infração. Depende de element_type.
• element_type: Tipo de elemento. ITM (item), QUE (perguntas e respostas), REV (avaliações de produtos).
• subgroup: Campo que permite identificar, agrupar e resumir infrações pertencentes a diferentes grupos de filtros.

• reason: texto (html) que descreve o motivo e a política infringida.
• remedy: texto (html) que indica a ação, apenas nos casos em que seja recuperável.

Moderações para VIS

A tabela a seguir lista as possíveis moderações aplicáveis às diferentes unidades de negócios relacionadas a veículos e imóveis (VIS), bem como as ações possíveis e algumas recomendações para corrigi-las:

Próximo: Moderações com pausa.