Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 04/04/2025
Listings quality
Quality levels by site
The quality level is separated by the level_wording field in the following way:
| Site | Bad quality | Average quality | Good quality |
|---|---|---|---|
| MLB | Básica | Satisfatória | Profissional |
| MLA | Básica | Estándar | Profesional |
| CBT | Basic | Standard | Professional |
| Outros sites | Básica | Estándar | Profesional |
Quality detail by item
To find out the quality level of an item, you have the /performance resource. Here, you can see all the quality data of the item, the number of objectives met and the applicable actions. You also know the level in which it falls.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/item/$ITEM_ID/performanceExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/item/MLA1435540505/performanceResponse:
{
"entity_type": "ITEM",
"entity_id": "MLA1435540505",
"score": 69,
"level": "Good",
"level_wording": "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"
}
}
]
}
]
}
]
}
Errors
Possible API errors:
| Error | Mensage | Reason |
|---|---|---|
| 400 | The request sent is not valid | Problems in formatting the request. |
| 401 | Caller must be the seller of the item | The item/user-product you are submitting does not belong to the access_token user. |
| 403 | You do not have permission to access this resource | Permission issues in access_token. |
| 404 | Not found item performance | Performance data not generated |
| 500 | We are presenting problems. We will solve them as soon as possible. | Internal error on the server. |