Calidad de publicaciones (inmuebles)

Niveles de calidad por sitio

El recurso /health_level te permite identificar el rango de puntuación necesario para cada nivel de publicación por país.

Llamada:

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

Ejemplo:

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

Respuesta:

[
   {
       "level": "basic",
       "health_min": 0,
       "health_max": 0.69
   },
   {
       "level": "standard",
       "health_min": 0.7,
       "health_max": 0.98
   },
   {
       "level": "professional",
       "health_min": 0.99,
       "health_max": 1
   }
]

Campos de la respuesta

level: identificación del nivel de calidad en que se encuentra la publicación: basic, standard y professional.
health_min e health_max: representan respectivamente los valores mínimos y máximos del rango de puntuación utilizado para identificar el nivel de calidad en el que la publicación esté.

Detalle de la calidad por ítem

Para conocer el nivel de calidad de un ítem, dispones del recurso /health. En este, puedes ver el porcentaje de calidad del ítem, el cual es calculado dividiendo la cantidad de objetivos cumplidos por la calidad de objetivos aplicables. Y además, conoces el nivel en el que se encuadra.

Llamada:

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

Ejemplo:

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

Respuesta:

{
    "item_id": "MLM735814032",
    "health": 0.66,
    "level": "basic",
    "goals": [
        {
            "progress": 0,
            "progress_max": 0,
            "id": "buybox",
            "name": "buybox",
            "apply": false
        },
        {
            "progress": 3,
            "progress_max": 9,
            "id": "technical_specification",
            "name": "technical_specification",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "variations",
            "name": "variations",
            "apply": false
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "product_identifiers",
            "name": "product_identifiers",
            "apply": true
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "picture",
            "name": "picture",
            "apply": true,
            "completed": "2019-11-28T09:34:05.437Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "price",
            "name": "price",
            "apply": false
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "me2",
            "name": "me2",
            "apply": true,
            "completed": "2019-11-28T09:34:05.416Z"
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "free_shipping",
            "name": "free_shipping",
            "apply": true,
            "completed": "2019-11-28T09:34:05.416Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "flex",
            "name": "flex",
            "apply": false
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "immediate_payment",
            "name": "immediate_payment",
            "apply": true,
            "completed": "2019-11-28T09:34:05.288Z"
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "classic",
            "name": "classic",
            "apply": true,
            "completed": "2019-11-28T09:34:05.289Z",
            "data": {
                "listing_type": "clásica"
            }
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "premium",
            "name": "installments_free",
            "apply": true,
            "data": {
                "listing_type": "premium"
            }
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "publish",
            "name": "publish",
            "apply": true,
            "completed": "2019-11-28T09:34:05.288Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "size_chart",
            "name": "size_chart",
            "apply": false
        }
    ]
}

Campos de la respuesta

id: identificador del objetivo.
name: nombre descriptivo.
apply: indica si el objetivo es aplicable para el ítem.
completed: muestra la fecha en la cual el objetivo fue cumplido. En caso de que este aún no haya sido cumplido o no aplique, este campo estará oculto.
progress_max: es el número que indica el mayor valor de progreso posible para ese objetivo.
progress: es el número que indica el valor actual del progreso en el objetivo. Cuando fuera igual al valor progress_max, significa que el objetivo fue alcanzado.
health: representa el porcentaje de calidad del ítem.

Acciones necesarias para mejorar la calidad de un ítem

Luego de identificar el nivel de calidad del ítem, en casos aplicables, es posible verificar cuáles son los objetivos que el vendedor aún tiene pendientes y puede ajustar para mejorar la calidad de publicación de la publicación y ganar más exposición.

Llamada:

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

Ejemplo:

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

Respuesta:

{
   "item_id": "MLM735814032",
   "health": 0.66,
   "actions": [
       {
           "id": "technical_specification",
           "name": "technical_specification"
       },
       {
           "id": "product_identifiers",
           "name": "product_identifiers"
       },
       {
           "id": "premium",
           "name": "installments_free"
       }
   ]
}

Descripción de las acciones

En actions puedes encontrar todas las acciones que te ayudarán a mejorar la calidad de la publicación. A continuación, puedes conocer todas las acciones posibles y los recursos que deberían ser verificados para realizar las mejoras:

Acciones para Inmuebles

picture: cantidad mínima de imágenes.
Calidad de publicaciones de Venta y Arriendo: Calidad de publicaciones de Venta y Arriendo .
technical_specification: completar los atributos técnicos específicos del ítem.
video: agrega contenido multimedia (YouTube/Tour virtual).
publish: es el objetivo relacionado a la publicación del ítem, realizado automáticamente al publicar.