Qualidade das publicações (imóveis)

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": "online_scheduling",
            "name": "online_scheduling",
            "apply": false
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "picture",
            "name": "picture",
            "apply": true,
            "data": {
                "min": 12
            }
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "technical_specification",
            "name": "technical_specification",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "video",
            "name": "video",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "upgrade_listing",
            "name": "upgrade_listing",
            "apply": true
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "publish",
            "name": "publish",
            "apply": true,
            "completed": "2025-04-15T17:43:56.096Z"
        }
    ]
}

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.2,
    "actions": [
        {
            "id": "picture",
            "name": "picture"
        },
        {
            "id": "technical_specification",
            "name": "technical_specification"
        },
        {
            "id": "video",
            "name": "video"
        },
        {
            "id": "upgrade_listing",
            "name": "upgrade_listing"
        }
    ]
}

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 Imóveis

picture: quantidade imagens mínimas.
technical_specification: complete os atributos técnicos específicos do item.
video: agregar conteúdo multimídia (YouTube/Tour virtual).
publish: objetivo referente a publicação do item, concluído automaticamente ao publicar.