Qualidade das publicações (veículos)

Níveis de qualidade por site

O recurso /health_level permite identificar o range de pontuação necessário para cada nível de publicação por país.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/health_levels

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/health_levels

Resposta:

[
   {
        "level": "basic",
        "health_min": 0,
        "health_max": 0.49
    },
    {
        "level": "standard",
        "health_min": 0.5,
        "health_max": 0.65
    },
    {
        "level": "professional",
        "health_min": 0.66,
        "health_max": 1
    }
]

Campos da resposta

level: identificação do nível de qualidade em que se encontra a publicação: basic, standard e professional.
health_min e health_max: representam respectivamente os valores mínimos e máximos do range de pontuação utilizado para identificar o nível de qualidade em que a publicação está.

Detalhe de qualidade por item

Para conhecer o nível de qualidade de um item, disponibilizamos o recurso /health. Nele apresentaremos a porcentagem de qualidade do item e o nível em que se enquadra. O percentual de qualidade é calculado dividindo a quantidade objetivos cumpridos pela quantidade objetivos aplicáveis.

Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM735814032/health

Resposta:

{
    "item_id": "MLM735814032",
    "health": 0.66,
    "level": "basic",
    "goals": [
       {
            "progress": 0,
            "progress_max": 1,
            "id": "picture",
            "name": "picture",
            "apply": true,
            "data": {
                "min": 10
            }
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "whatsapp",
            "name": "whatsapp",
            "apply": true
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "price",
            "name": "price",
            "apply": true,
            "completed": "2025-04-15T14:22:56.497Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "video",
            "name": "video",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "description",
            "name": "description",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "verification",
            "name": "verification",
            "apply": true,
            "data": {
                "is_data_filled": false
            }
        }
    ]
}

Campos da resposta

id: identificador do objetivo.
name: nome descritivo.
apply: indica se o objetivo é aplicável para o item.
completed: mostra a data na qual o objetivo foi cumprido. Caso ele ainda não tenha sido cuprido ou não seja aplicável, esse campo será oculto.
progress_max: número inteiro que indica o maior valor de progresso possível para esse objetivo.
progress: número inteiro que indica o valor atual do progresso no objetivo. Quando ele for igual ao progress_max, significa que o objetivo foi cumprido.
health: representa o percentagem de qualidade do item.

Ações necessárias para melhorar a qualidade de um item

Após identificar o nível de qualidade do item, em casos aplicáveis, é possível verificar quais são os objetivos que o vendedor ainda tem pendentes e pode ajustar para melhorar a qualidade da publicação e ganhar mais exposição.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/health/actions

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM735814032/health/actions

Resposta:

{
   "item_id": "MLM735814032",
  "health": 0.16,
    "actions": [
        {
            "id": "picture",
            "name": "picture"
        },
        {
            "id": "whatsapp",
            "name": "whatsapp"
        },
        {
            "id": "video",
            "name": "video"
        },
        {
            "id": "verification",
            "name": "verification"
        },
        {
            "id": "description",
            "name": "description"
        }
    ]
}

Descritivo das ações

Em actions você encontrará todas as ações que ajudarão a melhorar a qualidade da publicação. Listamos todas as possíveis e indicamos os recursos que devem ser verificados para fazer os ajustes:

Ações para automóveis

picture: quantidade imagens mínimas.
price: publicar com preço mais competitivo, caso seja aplicável, vamos indicar o range de preço que pode ser utilizado.
technical_specification: complete os atributos técnicos específicos do item.
video: publicar com vídeo apresentando o veículo.
upgrade_listing: aplique um upgrade no tipo da publicação.
publish: objetivo referente a publicação do item, concluído automaticamente ao publicar.