Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 31/10/2023

Gerenciar moderações

Com o recurso /infractions você acessa informações relacionadas com as infrações detectadas em itens, perguntas, respostas e opiniões de produtos.Para mais informação, consulte as políticas de publicação do Mercado Livre (Argentina, Brasil, México, Chile, Colômbia e Uruguai).
As moderações são classificadas em:

  • Inativa: a publicação foi baixada, e o vendedor não pode modificá-la ou recuperá-la.
  • Inativa para revisar: a publicação foi pausada, e pode ser reativada realizando as alterações necessárias.
  • Ativa perdendo exposição: a publicação está pendendo exposição, e devem ser feitas alterações nas fotos ou deve completar a ficha técnica para que cumpra os requisitos.


Filtrar itens com infrações

Para obter itens com moderação você pode consultar aquelas com status under_review, e sub-estado: warning, waiting_for_patch, held, pending_documentation, forbidden, picture_dowloading_pending filtrando mediante o status "pending".

Nota:
Não se esqueça de mostrar as moderações com status paused, como alterações incomuns de preço, e as moderações com status active, como as moderações de imagem.

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",
      "MLC949606444",
      "MLC947744555",
      "MLC947725666",
      "MLC947725777",
      "MLC947699888"
  ],
  "orders": [...]
}

Status, substatus e tags de moderações

Status Substatus Tag Detalhe
Closed moderation_penalty Item sem vendas.
Paused picture_downloading_pending Pausado por carregar foto com URL.
Paused moderation_penalty Alteração incomum de preços + item sem vendas.
Under review Waiting_for_patch Item pausado já que foram detectadas infrações e o usuário deve modificar para que se ative.
Under review Forbidden Item inabilitado pelo Mercado Livre. Substitui a Inactive.
Under review Held Inativa. Em revisão pelo Mercado Livre.
Under review pending_documentation Item con denúncia de Brand Protection Program.
Under review suspended, suspended_for_prevention Suspensão de itens com risco de operações fraudulentas
Active poor_quality_thumbnail Foto com má qualidade.
Active moderation_penalty Item com alguma penalidade. Pode modificar status, blureo ou outras.

Conheça mais sobre o fluxo e estado das publicações.


Consultar moderações de um usuário

Com a seguinte consulta, você pode ver as moderações com estados finais (forbidden) e temporais (waiting_for_patch, held, pending_documentation). Não verá os itens baixados por duplicados. Recomendamos que identifique o motivo (reason) e solução (remedy), e garanta acionáveis para os vendedores conforme o tipo de moderação recebida.

Nota:
Se o usuário está suspenso, consulte /users/$USER_ID e identifique o campo status => list => allow. Caso seja false, significa que está suspenso.

Parâmetros opcionais

Permitirão filtrar as moderações de um usuário, conforme:

  • 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 do filtrado. Formato: YYYY-MM-DD
  • date_created_to: data de fim do filtrado. Formato: YYYY-MM-DD
  • language: pode solicitar os textos do reason e remedy em idioma espanhol ou português. O idioma por default é inglês. ES (espanhol) ou PT (português).
  • limit: quantidade de infrações devolvidas. O valor é de 1 a 20. Por default 20.
  • offset: offset para o paginado.
  • sort: ordenar os resultados por data de criação de maneira ascendente ou descendente. Exemplo date_created_asc, date_created_desc.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&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": "MLA13520000",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "DESC",
          "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica 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": "MLA13862111", "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" }

Campos da resposta

  • id: identificador único da infração.
  • date_created: data em que foi produzida a infração.
  • user_id: o usuário que realizou a infração.
  • related_item_id: identificador único da publicação relacionada com o elemento que possui a infração. Se a infração é em uma publicação, o valor deste atributo será igual ao valor do atributo element_id.
  • element_id: identificador único do elemento que possui a infração. É dependente do atributo element_type.
  • element_type: tipo de elemento, os valores podem ser: ITM (publicação), QUE (perguntas e respostas) e REV (reviews de produtos).
  • subgroup: este campo te permite identificar, agrupar e resumir (sumarizar) as infrações pertencentes a distintos grupos de filtros.
filter_subgroup Moderação Solução
DOMAIN Publicações mal categorizadas Use o predictor de categorias.
PQT Qualidade da foto Conheça como melhorar imagens.
DESC Alteração incomum de preço Verifique o preço e ative a publicação.
OPT_OBEY Catálogo Crie a publicação no Catálogo.
COMPATS Compatibilidades Ofereça compatibilidade a productos de Auto-peças.
DUPLIS Publicações duplicadas Evitamos publicações repetidas e convidamos aos vendedor a modificá-la usandovariáveis nos productos. Saiba mais sobre os beneficios de criar variáveis.
LINKS, DP Dados de contato Evite incluir dados de contato nas publicações.
BRAND_PROTECTION Produtos falsificados e uso indevido de marca. Conheça como publicar sem infringir propriedade intelectual.
CLASI moderações de veículos, imóveis, serviços Conheça o que considerar para publicar veículos ou Imóveis.
  • reason: texto (html) que descreve o motivo e política que se infringiu.
  • remedy: texto (html) que indica a ação, apenas em casos recuperáveis.

Moderações para VIS

A tabela seguinte lista as possíveis moderações aplicáveis às diferentes unidades de negócio relacionadas com veículos e imóveis (VIS), como também as ações possíveis e algumas recomendações para corrigir a moderação:

BU Tipo Status Reason Remedy Recomendações
VIS-Motors Placa Duplicada under_review, Substatus: waiting_for_patch Pausamos a sua publicação porque tinha a mesma placa de outro veículo. Modifique-o e adicione os dados correctos para reativá-lo. Dar ao vendedor uma ação para que ele possa revisar suas publicações e corrigir o campo placa.
VIS-Motors Placa inválida under_review, Substatus: waiting_for_patch Pausamos sua publicação porque a placa está incorreta e não corresponde à marca, modelo e ano do veículo. Adicione as informações corretas para reativá-lo. Dar ao vendedor uma ação para que ele possa revisar as suas publicações e corrigir o campo placa.

Próxima: Moderações com pausa.