Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 19/02/2024

Moderações de imagens

Atualmente as moderações por má qualidade podem estar pelo status active ou paused, e ter a tag poor_quality_thumbnail. Conheça as recomendações para tirar boas fotos de Produtos, Moda, Veículos, Imóveis e Serviços.

Fluxo recomendado

  1. 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.
  2. 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
  3. Identifique os picture_ids internos afetados para reativar os anúncios.


  4. 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.


    Nota:
    Para adicionar a tag "poor_quality_thumbnail" a um item de teste, carregue os dados do seu usuário de teste no suporte por site: Argentina, México, Chile, Bolívia, Colômbia, Costa Rica, , República Dominicana, Equador, Uruguai, Peru.

    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.