Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Listings quality
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/health_levelsExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/health_levelsResponse:
[
{
"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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/healthExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM735814032/healthResponse:
{
"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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/health/actionsExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM735814032/health/actionsResponse:
{
"item_id": "MLM735814032",
"health": 0.66,
"actions": [
{
"id": "technical_specification",
"name": "technical_specification"
},
{
"id": "product_identifiers",
"name": "product_identifiers"
},
{
"id": "premium",
"name": "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.