Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentación
Calidad de publicaciones
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 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.
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.