Listings quality

The /health resource allows the integrator to show its users (sellers) the quality of the publications, knowing what goals are completed and those that are still pending, allowing the achievement of publication objectives and increasing the listings quality, thus improving the item exposure and also the sale and purchase experience.

Contents

→Quality levels by site
→Quality detail by item
→Necessary actions to improve the quality of an item



Quality levels by site

The /health_level resource allows you to identify the necessary scoring range for each listing level by country.

Request:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/health_levels

Example:

curl -X GET https://api.mercadolibre.com/sites/MLB/health_levels

Response:

[
   {
       "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
   }
]

Response fields

level: identification of the quality level in which the listing is located: basic, standard and professional.
health_min and health_max: respectively represent the minimum and maximum values of the range of punctuation used to identify the quality level in which the publication is.


Quality detail by item

To find out the quality level of an item, it is available the /health resource. In this, you can access to the quality percentage of the item, which is calculated by dividing the number of objectives met / quality of applicable objectives. In addition, you can see the level at which it falls.

Request:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/health?access_token=$ACCESS_TOKEN

Example:

curl -X GET https://api.mercadolibre.com/items/MLM735814032/health?access_token=$ACCESS_TOKEN

Response:

{
    "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
        }
    ]
}

Response fields

id: objective´s identifier.
name: descriptive name.
apply: indicates whether the objective is applicable for the item.
completed: shows the date on which the objective was achieved. If it has not yet been met or is not applicable, this field will be hidden.
progress_max: the number indicates the highest possible progress value towards that objetive.
progress: the number indicates the current progress value on the goal. When it is equal to progress_max, it means that the objective has been completed.
health: the quality percentage of the item.


Necessary actions to improve the quality of an item

After identifying the item's quality level, in applicable cases, it is possible to verify which are the objectives that the seller still has pending and can adjust to improve the publication's publication quality and get more exposure.

Request:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/health/actions?access_token=$ACCESS_TOKEN

Example:

curl -X GET https://api.mercadolibre.com/items/MLM735814032/health/actions?access_token=$ACCESS_TOKEN

Response:

{
   "item_id": "MLM735814032",
   "health": 0.66,
   "actions": [
       {
           "id": "technical_specification",
           "name": "technical_specification"
       },
       {
           "id": "product_identifiers",
           "name": "product_identifiers"
       },
       {
           "id": "premium",
           "name": "installments_free"
       }
   ]
}
Notes:
- To MLU, the "classic" ID action is called "installments_free".
- To MLV, MPE and MLU the "premium" ID action is called "installments_free".

Actions description

In actions you can find all the actions that will help you improve the quality of the publication. Below, you can find out all the possible actions and the resources that should be verified to make the improvements:

technical_specification: check the quality of the attributes and complete the technical file.
buybox: list on catalogue.
variations: use variations to listing.
product_identifiers: inform the product universal code.
picture: check the pictures quality.
price: list with a more competitive price, and if applicable, we will indicate the price range that you can use.
me2: use Mercado Envios in listings.
free_shipping: offer free shipping grátis.
flex: use Mercado Envios Flex.
immediate_payment: use Mercado Pago (immediate_payment tag).
classic: publish with at least Classic exposition.
premium (installments_free): List Premium listings.
size_chart: inform the size guide.
publish: objective regarding the item listing, completed automatically when listing.

or register to recieve the latest news about our API