Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 23/12/2024
Calidad de publicaciones
Niveles de calidad por sitio
El nivel de calidad está separado por sitio de la siguiente manera:
| Site | Bad | Medium | Good |
|---|---|---|---|
| MLB | Básica | Satisfatória | Profissional |
| MLA | Básica | Estándar | Profesional |
| CBT | Basic | Standard | Professional |
| Otros sites | Básica | Estándar | Profesional |
Detalle de la calidad por ítem
Para conocer el nivel de calidad de un ítem, dispones del recurso /performance. En este, puedes ver todos los datos de calidad del ítem, la cantidad de objetivos cumplidos y las acciones aplicables. Y además, conoces el nivel en el que se encuentra.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/performance
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1435540505/performance
Respuesta:
{
"entity_type": "ITEM",
"entity_id": "MLA1435540505",
"score": 69,
"level": "Profesional",
"calculated_at": "2024-07-02T14:56:58Z",
"buckets": [
{
"key": "CHARACTERISTICS",
"type": "",
"status": "PENDING",
"score": 74.337616,
"title": "Datos del producto",
"calculated_at": "2024-07-02T14:56:58Z",
"variables": [
{
"key": "GTIN",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Indicá el código universal de tu producto para no perder exposición",
"rules": [
{
"key": "HAS_GTIN",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Asegurate de completar el código que pertenezca a este producto para estar más arriba en los resultados de búsqueda.",
"label": "Completar código universal",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=universal_code_no_variations&itemId=MLA1435540505"
}
}
]
},
{
"key": "PICTURES",
"status": "PENDING",
"score": 33.333336,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Mejorá las fotos para tener más visitas",
"rules": [
{
"key": "PICTURES_QUANTITY_MIN",
"status": "PENDING",
"progress": 0.33333334,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Agregá más fotos para mostrar tu producto desde diferentes ángulos, subí 3 como mínimo.",
"label": "Agregar fotos",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=picture_uploader_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "TITLE",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Corregí el título para que puedan encontrar tu producto más fácil",
"rules": [
{
"key": "TITLE_LENGTH_MIN",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Sumá más detalles, el título debe tener al menos 3 palabras.",
"label": "Mejorar título",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=title_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "TECHNICAL_SPECIFICATIONS_MAIN",
"status": "PENDING",
"score": 47.499996,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Corregí las características para recibir menos preguntas y devoluciones",
"rules": [
{
"key": "TS_MAIN_QUANTITY",
"status": "PENDING",
"progress": 0.67499995,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Completá las características principales.",
"label": "Completar características",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=technical_specifications_task&itemId=MLA1435540505"
}
},
{
"key": "TS_MAIN_QUALITY_INCOMPLETE_REQUIRED",
"status": "PENDING",
"progress": 1,
"mode": "WARNING",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Completá los datos marcados como “requeridos”.",
"label": "Completar características",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=technical_specifications_task&itemId=MLA1435540505"
}
}
]
}
]
},
{
"key": "OFFER",
"type": "",
"status": "PENDING",
"score": 61.111107,
"title": "Condiciones de venta",
"calculated_at": "2024-07-02T14:56:58Z",
"variables": [
{
"key": "STOCK_AVAILABILITY_TIME",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Reducí el tiempo de disponibilidad para que tu publicación sea más competitiva",
"rules": [
{
"key": "BEST_STOCK_AVAILABILITY_TIME",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Reducí el tiempo de disponibilidad para que tu publicación sea más competitiva",
"label": "Modificar tiempo",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=stock_availability_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "FREE_SHIPPING",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Ofrecé envío gratis para que tu publicación sea más competitiva",
"rules": [
{
"key": "HAS_FREE_SHIPPING",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Ofrecé envío gratis para que tu publicación sea más competitiva",
"label": "Modificar envío",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=shipping_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "ME",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Ofrecé envíos con Mercado Libre para que te compren desde todo el país",
"rules": [
{
"key": "HAS_MERCADO_ENVIOS",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Ofrecé envíos con Mercado Libre para que te compren desde todo el país",
"label": "Modificar envío",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=shipping_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "FINANCING",
"status": "PENDING",
"score": 0,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Agregá cuotas al mismo precio que publicaste para que tu publicación sea más competitiva",
"rules": [
{
"key": "BEST_FINANCING",
"status": "PENDING",
"progress": 0,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Agregá cuotas al mismo precio que publicaste para que tu publicación sea más competitiva",
"label": "Agregar cuotas",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=listing_types_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "STOCK_DEPOSITO",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-07-02T14:56:58Z",
"title": "Agregá más stock y evitá perder ventas",
"rules": [
{
"key": "HAS_STOCK_DEPOSITO",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-07-02T14:56:58Z",
"wordings": {
"title": "Asegurate de que tu publicación tenga 2 o más unidades disponibles.",
"label": "Agregar unidades",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=stock_sku_task&itemId=MLA1435540505"
}
}
]
}
]
}
]
}
Detalle de la calidad por User Product
Además es posible obtener los detalles a nível User Product, consultando todos los datos de calidad, su nível y acciones necesarias:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-product/$USER-PRODUCT-ID/performance
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-product/MLAU395977691/performance
Respuesta:
{
"entity_type": "USER_PRODUCT",
"entity_id": "MLAU395977691",
"score": 68,
"level": "Profesional",
"calculated_at": "2024-12-10T14:17:59Z",
"buckets": [
{
"key": "USER_PRODUCT",
"type": "USER_PRODUCT",
"status": "PENDING",
"score": 78.31277,
"title": "Datos del producto",
"calculated_at": "2024-12-10T14:17:58Z",
"variables": [
{
"key": "UP_PICTURES",
"status": "PENDING",
"score": 33.333336,
"calculated_at": "2024-12-10T14:17:58Z",
"title": "Mejorá las fotos para tener más visitas",
"rules": [
{
"key": "UP_PICTURES_QUANTITY_MIN",
"status": "PENDING",
"progress": 0.33333334,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:58Z",
"wordings": {
"title": "Agregá más fotos para mostrar tu producto desde diferentes ángulos, subí 3 como mínimo.",
"label": "Agregar fotos",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/picture-uploader-default"
}
}
]
},
{
"key": "UP_TECHNICAL_SPECIFICATIONS_MAIN",
"status": "PENDING",
"score": 65,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Corregí las características para recibir menos preguntas y devoluciones",
"rules": [
{
"key": "UP_TS_MAIN_QUANTITY",
"status": "PENDING",
"progress": 0.85,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Completa las características principales.",
"label": "Completar características",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/techspecs-primary"
}
},
{
"key": "UP_TS_MAIN_QUALITY_INCOMPLETE_REQUIRED",
"status": "PENDING",
"progress": 1,
"mode": "WARNING",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Completá los datos marcados como “requeridos”.",
"label": "Completar características",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/techspecs-primary"
}
}
]
},
{
"key": "UP_GTIN",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Indicá el código universal de tu producto para no perder exposición",
"rules": [
{
"key": "UP_HAS_GTIN",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Asegurate de completar el código que pertenezca a este producto para estar más arriba en los resultados de búsqueda.",
"label": "Completar código universal",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/universal-code-default"
}
}
]
},
{
"key": "UP_STOCK_DEPOSITO",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Revisa tu stock para que puedas seguir vendiendo",
"rules": [
{
"key": "UP_HAS_STOCK_DEPOSITO",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Agregá stock a tu publicación",
"label": "Agregar unidades",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/stock-sku-default"
}
}
]
},
{
"key": "UP_TITLE",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Corregí el título para que puedan encontrar tu producto más fácil",
"rules": [
{
"key": "UP_TITLE_LENGTH_MIN",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Sumá más detalles, el título debe tener al menos 3 palabras.",
"label": "Mejorar título",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/title-default"
}
}
]
},
{
"key": "UP_STOCK_AVAILABILITY_TIME",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Reducí el tiempo de disponibilidad para que tu publicación sea más competitiva",
"rules": [
{
"key": "UP_BEST_STOCK_AVAILABILITY_TIME",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Reducí el tiempo de disponibilidad para que tu publicación sea más competitiva",
"label": "Modificar tiempo",
"link": "https://www.mercadolibre.com.ar/publicaciones/MLAU395977691/modificar/omni/variation/dominio/stock-availability-default"
}
}
]
}
]
},
{
"key": "MLA1435540505",
"type": "ITEM",
"status": "PENDING",
"score": 53.33333,
"title": "Condiciones de venta",
"calculated_at": "2024-12-10T14:17:58Z",
"variables": [
{
"key": "UP_FINANCING",
"status": "PENDING",
"score": 0,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Agregá cuotas al mismo precio que publicaste para que tu publicación sea más competitiva",
"rules": [
{
"key": "UP_BEST_FINANCING",
"status": "PENDING",
"progress": 0,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Agregá cuotas al mismo precio que publicaste para que tu publicación sea más competitiva",
"label": "Agregar cuotas",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=listing_types_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "UP_FREE_SHIPPING",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Ofrecé envío gratis para que tu publicación sea más competitiva",
"rules": [
{
"key": "UP_HAS_FREE_SHIPPING",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Ofrecé envío gratis para que tu publicación sea más competitiva",
"label": "Modificar envío",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=shipping_task&itemId=MLA1435540505"
}
}
]
},
{
"key": "UP_ME",
"status": "COMPLETED",
"score": 100,
"calculated_at": "2024-12-10T14:17:59Z",
"title": "Ofrecé envíos con Mercado Libre para que te compren desde todo el país",
"rules": [
{
"key": "UP_HAS_MERCADO_ENVIOS",
"status": "COMPLETED",
"progress": 1,
"mode": "OPPORTUNITY",
"calculated_at": "2024-12-10T14:17:59Z",
"wordings": {
"title": "Ofrecé envíos con Mercado Libre para que te compren desde todo el país",
"label": "Modificar envío",
"link": "https://www.mercadolibre.com.ar/syi/core/modify?taskId=shipping_task&itemId=MLA1435540505"
}
}
]
}
]
}
]
}
Campos de la respuesta
Estos son el detalle de los datos que devuelve la API:
- entity_type: Indica qué tipo de entidad es el ID consultado, si ITEM o USER_PRODUCT.
- entity_id: Id del ITEM/USER_PRODUCT.
- score: Representa el porcentaje de calidad del ítem. La escala va de 0 a 100.
- level: Identificación del nivel de calidad en que se encuentra el ítem: Básica, Estándar o Profesional.
- calculated_at: Fecha y hora del último cálculo de la calidad del ítem.
- buckets: Lista de objetos del tipo bucket.
- key: Identificador de la entidad.
- type: Indica si el bucket pertenece a un ITEM o un USER_PRODUCT.
- status: Indica el estado de la entidad. "PENDING" si faltan realizar acciones o "COMPLETED" si se realizaron todas.
- score: Indica el porcentaje cumplido.
- calculated_at: Fecha y hora del último cálculo de la entidad.
- title: Texto principal de la entidad.
- variables: Lista de objetos del tipo variable.
- key: Identificador de la entidad.
- status: Indica el estado de la entidad. "PENDING" si faltan realizar acciones o "COMPLETED" si se realizaron todas.
- score: Indica el porcentaje cumplido.
- calculated_at: Fecha y hora del último cálculo de la entidad.
- title: Texto principal de la entidad.
- rules: Lista de objetos del tipo rule.
- key: Identificador de la entidad.
- status: Indica el estado de la entidad. "PENDING" si faltan realizar acciones o "COMPLETED" si se realizaron todas.
- progress: Indica el porcentaje cumplido.
- mode: Indica si la entidad es del tipo OPPORTUNITY, oportunidades para mejorar la calidad de la publicación, o WARNING, problemas con la calidad que disminuyen el score hasta que se resuelvan.
- calculated_at: Fecha y hora del último cálculo de la entidad.
- wordings: Textos utilizados en la entidad.
- title: Texto principal de la entidad.
- label: Texto para representar el link.
- link: URL que lleva al vendedor a completar el objetivo.
Errores
Posibles errores en la API:
| Error | Mensaje | Motivo |
|---|---|---|
| 400 | The request sent is not valid | Problemas de formateo de la request |
| 401 | Caller must be the seller of the item | El ítem/user-product que estás enviando no pertenece al usuario del access_token |
| 403 | You do not have permission to access this resource | Problemas de permisos en el access_token |
| 404 | Not found item performance | Datos de rendimiento no generados |
| 500 | We are presenting problems. We will solve them as soon as possible. | Error interno en el servidor |