Listings quality

Quality levels by site

The quality level is separated by the level_wording field in the following way:

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/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": "OFFER",
           "type": "",
           "status": "PENDING",
           "score": 61.111107,
           "title": "Condiciones de venta",
           "calculated_at": "2024-07-02T14:56:58Z",
           "variables": [
               {
                   "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"
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

Response fields

Main response object:

• entity_type (String): Type of entity being evaluated. Values: "ITEM".
• entity_id (String): The item ID being evaluated.
• score (Float): Quality score from 0 to 100.
• level (String): Quality level. Values: "Bad", "Average", "Good".
• level_wording (String): Localized quality level name based on site (e.g., "Profesional", "Profissional", "Professional").
• calculated_at (String): ISO 8601 timestamp of when the quality was calculated.
• buckets (Array): Array of bucket objects containing quality metrics grouped by category.

Bucket object:

• key (String): Bucket identifier. Values: "CHARACTERISTICS", "OFFER".
• type (String): Bucket type (usually empty).
• status (String): Bucket status. Values: "PENDING", "COMPLETED".
• score (Float): Bucket score from 0 to 100.
• title (String): Localized bucket title.
• calculated_at (String): ISO 8601 timestamp.
• variables (Array): Array of variable objects with specific quality metrics.

Variable object:

• key (String): Variable identifier (e.g., "GTIN", "PICTURES", "TITLE", "FREE_SHIPPING").
• status (String): Variable status. Values: "PENDING", "COMPLETED".
• score (Float): Variable score from 0 to 100.
• calculated_at (String): ISO 8601 timestamp.
• title (String): Localized variable title with action suggestion.
• rules (Array): Array of rule objects with specific validation criteria.

Rule object:

• key (String): Rule identifier (e.g., "HAS_GTIN", "PICTURES_QUANTITY_MIN").
• status (String): Rule status. Values: "PENDING", "COMPLETED".
• progress (Float): Progress value from 0 to 1.
• mode (String): Rule mode. Values: "OPPORTUNITY", "WARNING".
• calculated_at (String): ISO 8601 timestamp.
• wordings (Object): Contains localized text for title, label, and link.

Errors

Possible API errors: