Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 28/08/2024

Calidad de publicaciones

El recurso /health te permite mostrarle a los usuarios (vendedores) la calidad de las publicaciones, sabiendo qué acciones están cumplidas y las pendientes. De esta manera, pueden alcanzar los objetivos de publicación y aumentar la calidad de las publicaciones, mejorando la exposición del ítem y también la experiencia de venta y compra.


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

Importante:
Tus publicaciones pueden ser penalizadas por no contar con size_chart. Para evitarlo, carga la Guía de talles para mejorar la calidad de tu publicación.

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"
       }
   ]
}
Notas:
- Para MLU, la acción del ID "classic" es "installments_free".
- Para MLV, MPE y MLU, la acción del ID "premium" es "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 productos

technical_specification: verifica la calidad de los atributos y completa la ficha técnica.
buybox: publica en catálogo.
variations: utiliza variaciones para la publicación.
product_identifiers: informar código universal del producto.
picture: verifica la calidad de las imágenes.
price: publica con precio más competitivo, y en caso de que aplique, te vamos a indicar el rango de precio que puedes utilizar.
me2: utiliza Mercado Envíos en las publicaciones.
free_shipping: ofrece envíos gratis.
flex: utiliza Mercado Envíos Flex.
immediate_payment: utiliza Mercado Pago (tag immediate_payment).
classic: realiza una publicación con exposición al menos clásica.
premium (installments_free): Realiza una publicación como premium.
size_chart: informa una guía de talles.
publish: es el objetivo relacionado a la publicación del ítem, realizado automáticamente al publicar.
picture_fashion: verifica la calidad de las imágenes en tus publicaciones de moda.



Acciones para Vehículos

picture: cantidad mínima de imágenes.
price: publicar con precio más competitivo, y en caso de que aplique, te vamos a indicar el rango de precio que puedes utilizar.
technical_specification: completar los atributos técnicos específicos del ítem.
video: cargar video presentando el vehículo.
upgrade_listing: aplicar un upgrade en el tipo de la publicación.
publish: es el objetivo relacionado a la publicación del ítem, realizado automáticamente al publicar.


Nota:
La carga de whatsapp en las publicaciones no es más un objetivo considerado para la Calidad de la publicación, todavía sigue teniendo un impacto positivo sobre las conversiones de los ítems.

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.