Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 26/02/2026
Listings quality
Quality levels by site
The quality level is separated by site in the level_wording field as follows:
| Site | Bad | Medium | Good |
|---|---|---|---|
| MLB | Básica | Satisfatória | Profissional |
| MLA | Básica | Estándar | Profesional |
| CBT | Basic | Standard | Professional |
| Other sites | Básica | Estándar | Profesional |
Quality detail per item
To know the quality level of an item, you have the /performance resource available. Here, you can see all the item's quality data, the number of completed goals and applicable actions. Additionally, you can see the level it is at.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/item/$ITEM_ID/performance
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/item/MLA1435540505/performance
Response:
{
"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"
}
}
]
}
]
}
]
}
Quality detail per User Product
Additionally, it is possible to get details at the User Product level, querying all quality data, its level and necessary actions:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-product/$USER-PRODUCT-ID/performance
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-product/MLAU395977691/performance
Response:
{
"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"
}
}
]
}
]
}
]
}
Response fields
These are the details of the data returned by the API:
- entity_type: Indicates what type of entity the queried ID is, whether ITEM or USER_PRODUCT.
- entity_id: ITEM/USER_PRODUCT ID.
- score: Represents the item's quality percentage. The scale ranges from 0 to 100.
- level: Identification of the quality level the item is at: Basic, Standard or Professional.
- calculated_at: Date and time of the last item quality calculation.
- buckets: List of bucket type objects.
- key: Entity identifier.
- type: Indicates whether the bucket belongs to an ITEM or a USER_PRODUCT.
- status: Indicates the entity's status. "PENDING" if actions are missing or "COMPLETED" if all have been performed.
- score: Indicates the percentage completed.
- calculated_at: Date and time of the last entity calculation.
- title: Main text of the entity.
- variables: List of variable type objects.
- key: Entity identifier.
- status: Indicates the entity's status. "PENDING" if actions are missing or "COMPLETED" if all have been performed.
- score: Indicates the percentage completed.
- calculated_at: Date and time of the last entity calculation.
- title: Main text of the entity.
- rules: List of rule type objects.
- key: Entity identifier.
- status: Indicates the entity's status. "PENDING" if actions are missing or "COMPLETED" if all have been performed.
- progress: Indicates the percentage completed.
- mode: Indicates whether the entity is of type OPPORTUNITY, opportunities to improve listing quality, or WARNING, quality issues that decrease the score until resolved.
- calculated_at: Date and time of the last entity calculation.
- wordings: Texts used in the entity.
- title: Main text of the entity.
- label: Text to represent the link.
- link: URL that takes the seller to complete the goal.
Errors
Possible API errors:
| Error | Message | Reason |
|---|---|---|
| 400 | The request sent is not valid | Request formatting issues |
| 401 | Caller must be the seller of the item | The item/user-product you are sending does not belong to the access_token user |
| 403 | You do not have permission to access this resource | Permission issues with the 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 server error |