Infrações

Com o recurso /infractions terá acesso a informações relacionadas a infrações encontradas em anúncios, perguntas, respostas e opinião do produto.

Conteúdos

Antes de consultar uma infração
→Consultar anúncios com estado under review

Consultar infrações

→Consultar moderações de um usuário
→Filtrar moderações

Moderación de imágenes

→Consultar moderação de imagens
↳Erros
↳Como melhorar a imagem
→Adicionar tag poor_quality_thumbnail no anúncio de teste

Infrações de Vehículos, Imóveis e Serviços
→Consultar moderações de Veículos, Imóveis e Serviços



Consultar anúncios com estado under review

Os anúncios em under review tem diferentes sub-estados (warning, waiting_for_patch, held, pending_documentation, forbidden) que são os motivos pelo qual estão em under_review. Por consequência estes anúncios são agrupados no 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",
        "MLC949606444",
        "MLC947744555",
        "MLC947725666",
        "MLC947725777",
        "MLC947699888"
    ],
    "orders": [...]
}

Conheça mais sobre fluxos e estados de anúncios.

Notas:
- Antes de consultar as moderações de um usuário: recomendamos consultar o estado dos anúncios (https://api.mercadolibre.com/items/$ITEM_ID).
- Ao consultar as moderações de um usuário: não verá os anúncios moderados por duplicados, aparecem apenas os anúncios com os estados que podem ser finais (forbidden) ou temporários (waiting_for_patch, held, pending_documentation).
- Talvez o usuário esteja suspenso, consulte https://api.mercadolibre.com/users/$USER_ID e verifique o campo status => list => allow. Caso seja "false", significa que está suspenso.

Consultar moderações de um usuário

As moderações de um vendedor podem impactar:

  • Anúncios
  • Perguntas e respostas (questions)
  • Opinião do produto (review)

Recomendamos identificar a razão (reason) e solução (remedy) para aplicar o idioma correspondente ao site de infração ou em inglês, além disso, poderá identificar e sumarizar as moderações por diferentes motivos.
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": "1025647",
           "date_created": "2016-11-12T18:28:03.731Z",
           "user_id": "6540387",
           "related_item_id": "MLA642576340",
           "element_id": "MLA642576340",
           "element_type": "ITM",
           "site_id": "MLA",
           "filter_subgroup": "LINKS",
           "reason": "Tuvimos que borrar tu publicación porque ofrecías un producto que está prohibido por nuestra Política de Autopartes y repuestos.",
           "remedy": "Recuerda que las autopartes y repuestos usados están regulados por las leyes 25761, 24449 y sus decretos reglamentarios.

Si deseas obtener más información puedes consultar el sitio de DNRPA" }, ], "paging": { "offset": 0, "limit": 20, "total": 7 }, "sorting_type": "date_created_desc" }

Resposta por má categorização (subgroup: DOMAIN):

{
    "infractions": [
        {
            "id": "803871756",
            "date_created": "2021-07-26T14:01:04.198-0400",
            "user_id": "743702276",
            "related_item_id": "MLA924367822",
            "element_id": "MLA924367822",
            "element_type": "ITM",
            “subgroup” : “DOMAIN”,
            "site_id": "MLA",
            "reason": "La anulamos porque después de analizar las fotos y el título, detectamos que no coinciden con la categoría.",
            "remedy": "Anulamos tu publicación. Lo hicimos porque la categoría en la que publicaste no era la apropiada. Vuelve a publicar el producto en la categoría correcta.",
            "suggested": {
                "domain": "AUTOMOTIVE_EMBLEMS",
                "categories": [
                    {
                        "id": "MLB22714",
                        "name": "Emblemas",
                        "path": "Acessórios para Veículos > Peças de Carros e Caminhonetes      > Peças de Exterior > Emblemas"
                    },
                    {
                        "id": "MLB412408",
                        "name": "Insignias",
                        "path": "Acessórios para Veículos > Acessórios para Caminhões > Cabine > Insignias"
                    }
                ]
   }
        }
    ],
        "paging": {
        "offset": 0,
        "limit": 20,
        "total": 7
    },
    "sorting_type": "date_created_desc"
}

Campos da resposta

id: identificador único da infração
date_created: data em que se cometeu a infração
user_id: o usuário que realizou a infração
related_item_id: identificador único do anúncio relacionado ao elemento que possuí a infração. Se a infração é em um anúncio, o valor deste atributo será igual ao valor do atributo element_id
element_id: identificador único do elemento que possuí a infração. É dependente do atributo element_type
element_type: os valores podem ser: ITM (anúncio), QUE (perguntas e respostas) y REV (opiniões de produtos)
site_id: site do marketplace do elemento que tem infração
subgroup: este campo permite identificar, agrupar e resumir (sumarizar) as infrações pertencentes aos diferentes grupos de filtros

  • DOMAIN: moderação por má categorização
  • PQT: moderação por má qualidade de imagens
  • LINKS: moderação por incluir dados de contato ou links externos no Mercado Libre
  • CLASI: moderações em classificados (veículos, imóveis, serviços)
  • BRAND_PROTECTION: moderação por denúncias realizadas pelo Brand Protection Program e devem ser respondidas antes do vencimento.
  • reason: texto (html) que descreve o motivo e política infringida
    remedy: texto (html) que indica a ação, apenas em casos em que se pode recuperar. Por exemplo “Excluir os dados pessoais de um anúncio”
    suggested: (opcional) são as sugestões se as infrações foram pelos filtros
    "MAL_CATEGORIZADO_CORE_A_CORE",
    "DOMAIN_WRONG_CATEG_V2",
    "DOMAIN_WRONG_CATEG_VENTAS_V2",
    "DOMAIN_WRONG_CATEG_CATALOGO",
    "DOMAIN_WRONG_CATEG_MANUAL",
    "DOMAIN_WRONG_CATEG_CBT_PICTURE_V2",
    "DOMAIN_WRONG_CATEG_VENTAS_CBT_PICTURE_V2",
    "DOMAIN_WRONG_CATEG_CBT_TEXT_V2",
    "DOMAIN_WRONG_CATEG_VENTAS_CBT_TEXT_V2"



    Filtras moderações

    Filtro Descrição Opções Default
    related_item_id Id do anúncio associado a infração - -
    element_id Id do elemento moderado - -
    element_type Tipo de elemento moderado ITM (anúncio)
    REV (opinião do produto)
    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 Poderá solicitar os textos do reason y remedy no idioma espanhol ou português. O idioma será inglês por padrão. ES (espanhol) ou PT (português) Inglês
    limit Quantidade de infrações devolvidas O valor é de 1 a 20 20
    offset Offset para o paginado 0
    sort Ordenar os resultados por data de criação de maneira ascendente ou descendente. 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"
    }

    Consultar moderações de imagens

    Os anúncios com a tag poor_quality_thumbnail foram validados pelo Mercado Livre e não cumprem algum requisito de imagem. Indetifique estes anúncios com imagens de baixa qualidade para melhorá-las. Conheça mais sobre o recurso em Busca de anúncios e a importância das fotos para os vendedores.


    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"
    }

    Campos da resposta:

    itemID: ID do anúncio
    quality: qualidade da imagem, pode tomar os valores “good” ou “poor”, definindo os estados de “boa imagem” ou “imagem ruim” respectivamente.
    thumbnail: é a imagem pela qual o anúncio foi processado, corresponde a thumbnail do anúncio.
    conditions: são um conjunto de condições pelas quais o anúncio passa para determinar sua qualidade de imagem. Uma condição está formada pelo seu ID (dando uma definição curta do que fazer) e seu atributo de passed, um valor booliano definindo se a imagem cumpre a condição ou não.
    taggedDate: data do último processamento realizado sobre el anúncio.


    Possíveis ids de condições

    minimum_size: valida se alguma das imagens do anúncio supera o tamanho mínimo de 500 x 500 px.
    logo_text_watermark: alida se a primeira do anúncio contém logos, texto, banners promocionais ou marca d'água.
    white_background: valida se a primeira imagem do anúncio tem fundo branco criado com um editor de imagem ao invés de uma foto do produto em frene a uma parede ou outro elemento.
    multiproduct: valida se a primeira imagem contém mais de um produto. Por exemplo, não permitimos imagens de um anúncio com vários pares de tênis.
    blur: valida se as imagens do anúncio não estão borradas.
    unprofessional_photo: esta validação se usa quando as outras dão negativo. Avalia três condições por vez: multiproduto, fundo branco e logos. Não significa que a imagem cumpre as três, sim, que pode não estar cumprindo com alguma das três.
    rollbacked: esta validação é reservada para a equipe de atenção ao cliente. A usamos quando um vendedor entra em contato para reclamar por moderações incorretas (falso positivo). Uma vez aplicada, a foto não volta a ser moderada, exceto se o vendedor alterar a imagem.


    Erros

    Caso receba um erro 404 - “No picture tagged for item (Item_id)” devido a que o anúncio não pôde ser validado, recomendamos melhorar a imagem com o seguinte recurso.


    Como melhorar a imagem

    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 corrigir a imagem do anúncio moderado, faremos novamente as validações e caso cumpram com os requisitos, a moderação será excluída e o anúncio irá recuperar exposição.

    Conheça mais sobre como trabalhar com imagens.


    Adicionar tag poor_quality_thumbnail no anúncio de teste

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


    Consultar moderações de Veículos, Imóveis e Serviços

    As moderações acontecem quando o vendedor não cumpre alguma das seguintes políticas e você pode identificá-lo com os seguintes filtros:

    • Iten duplicado: BS_EXACT_DUPLICATE_RE
    • Área total e/ou cobertura insignificante: CLASSI_DERISORY_AREA
    • Preço abaixo do mínimo que definimos: PRECIO_MINIMO_PROHIBIDO_RE
    • Preço insignificante, alto ou baixo: WTF_WRONG_PRICE_RE
    • Dados pessoais em imagens, descrição e título: OCR_GOO_ML_DATOS_PERSONALES
    • Inclusão de dados pessoais: SH_DATOS_PERSONALES, QR_CODE_AUTO
    • Quilômetros insignificante: CLASSI_DERISORY_KM
    • Veículos 0 km de anos antigos: CLASSI_YEAR_CONDITION_NEWS

    Exemplo de iten moderado:

    {
      "id": "898245251",
      "date_created": "2022-02-09T13:46:16.630-0400",
      "filter_name": "PRECIO_PROHIBIDO_MIN_RE",
      "user_id": "147120165",
      "filter_group": "TP",
      "related_item_id": "MLA1103438619",
      "element_id": "MLA1103438619",
      "element_type": "ITM",
      "site_id": "MLA",
      "moderation_id": "2173471581",
      "evidences": [{
        "text_matched": "No se puede publicar nada en MLA menor a 1.5e+06",
        "filter_rule": null,
        "section_name": "price"
      }],
      "scoring_value": "0",
      "scoring_id": "not_apply",
      "related_filter_name": "PRECIO_PROHIBIDO"
    },
    
    Nota:
    Para resolver cada Infração, recomendamos consultar o campo “remedy”. Por exemplo: para preço insignificante: "Você teria um preço insignificante para esse tipo de inmóvei, revise e corrija o preço".

    Todos os itens com status under_review, sub status: forbidden não podem ser modificados pela integração e só podem ser excluídos. Além disso, itens com status under_review podem ocupar o cuotas "Silver" (o mesmo aconteceria com um destaque). Para liberar o cuotas , você deve fazer DELETE o item moderado (duplicado) ou fazer com que o usuário o finalize a partir de sua conta do Mercado Livre.


    Próxima: Brand Protection Program.

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