Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 28/12/2022
Best sellers in Mercado Libre
Best sellers by category
Consult the 20 items/products top from a specific category.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/category/$CATEGORY_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/category/MLB432825Response:
{
"query_data": {
"highlight_type": "BEST_SELLER",
"criteria": "CATEGORY",
"id": "MLB432825"
},
"content": [
{
"id": "MLB1481736854",
"position": 1,
"type": "ITEM"
},
{
"id": "MLB1530545830",
"position": 2,
"type": "ITEM"
},
{
"id": "MLB1692302041",
"position": 3,
"type": "ITEM"
},
{
"id": "MLB1480437372",
"position": 4,
"type": "ITEM"
},
{
"id": "MLB1415573454",
"position": 5,
"type": "ITEM"
},
{
"id": "MLB1775202155",
"position": 6,
"type": "ITEM"
},
{
"id": "MLB1470331312",
"position": 7,
"type": "ITEM"
},
{
"id": "MLB1917662040",
"position": 8,
"type": "ITEM"
},
{
"id": "MLB1775121349",
"position": 9,
"type": "ITEM"
},
{
"id": "MLB1646755234",
"position": 10,
"type": "ITEM"
},
{
"id": "MLB1914214929",
"position": 11,
"type": "ITEM"
},
{
"id": "MLB1773591467",
"position": 12,
"type": "ITEM"
},
{
"id": "MLB1775162236",
"position": 13,
"type": "ITEM"
},
{
"id": "MLB1690035398",
"position": 14,
"type": "ITEM"
},
{
"id": "MLB1480477864",
"position": 15,
"type": "ITEM"
},
{
"id": "MLB1775187545",
"position": 16,
"type": "ITEM"
},
{
"id": "MLB1671977510",
"position": 17,
"type": "ITEM"
},
{
"id": "MLB1658084769",
"position": 18,
"type": "ITEM"
},
{
"id": "MLB1614538979",
"position": 19,
"type": "ITEM"
},
{
"id": "MLB1627711451",
"position": 20,
"type": "ITEM"
}
]
}Fields response
query_data: type of filter applied information
content:
- id: item or product id
- position: position on the list
- type: element type (item/product)
Best sellers by category and brand attribute
You can get the 20 items/products list according a brand marca from a specific category.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/category/$CATEGORY_ID?attribute_name=BRAND&attribute_value=9344Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLA/category/MLA1055?attribute_name=BRAND&attribute_value=9344Response:
{
"query_data": {
"highlight_type": "BEST_SELLER",
"criteria": "CATEGORY",
"id": "MLA1055"
},
"content": [
{
"id": "MLA17706115",
"position": 1,
"type": "PRODUCT"
},
{
"id": "MLA16150548",
"position": 2,
"type": "PRODUCT"
},
{
"id": "MLA16141545",
"position": 3,
"type": "PRODUCT"
},
{
"id": "MLA17706117",
"position": 4,
"type": "PRODUCT"
},
{
"id": "MLA17369333",
"position": 5,
"type": "PRODUCT"
},
{
"id": "MLA15946515",
"position": 6,
"type": "PRODUCT"
},
{
"id": "MLA16141547",
"position": 7,
"type": "PRODUCT"
},
{
"id": "MLA17369332",
"position": 8,
"type": "PRODUCT"
},
{
"id": "MLA16107499",
"position": 9,
"type": "PRODUCT"
},
{
"id": "MLA17464694",
"position": 10,
"type": "PRODUCT"
},
{
"id": "MLA17706118",
"position": 11,
"type": "PRODUCT"
},
{
"id": "MLA918309355",
"position": 12,
"type": "ITEM"
},
{
"id": "MLA17324819",
"position": 13,
"type": "PRODUCT"
},
{
"id": "MLA17426238",
"position": 14,
"type": "PRODUCT"
},
{
"id": "MLA17415926",
"position": 15,
"type": "PRODUCT"
},
{
"id": "MLA17457352",
"position": 16,
"type": "PRODUCT"
},
{
"id": "MLA17464698",
"position": 17,
"type": "PRODUCT"
},
{
"id": "MLA16217275",
"position": 18,
"type": "PRODUCT"
},
{
"id": "MLA17706116",
"position": 19,
"type": "PRODUCT"
},
{
"id": "MLA17493810",
"position": 20,
"type": "PRODUCT"
}
]
}Product position
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/product/$PRODUCT_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/product/MLB15960724Response:
{
"dimension": "category",
"id": "MLB1055",
"label": "Celulares e Smartphones",
"position": 19
}Item position
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/item/$ITEM_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLM/item/MLM16140709Response:
{
"dimension": "category",
"id": "MLM126793",
"label": "Smartwatches",
"position": 5
}Fields response
dimension: criterio utilizado (category)
- id: dimension id
- label: dimension tittle
- position: producto or item position (depend request) in the list
Errors
| Error | Description | Solution |
|---|---|---|
| 400 | Error site: ML | Send valid site_id |
| 400 | Invalid product id MLB | Send valid product/item_id |
| 401 | unspecified_token | Send valid access token |
| 404 | item/product with id MLB15960724 not found | The item/product isn´t in the "Más vendidos" list |
| 404 | Dimension CATEGORY with id MLB432825 not found | The category has not "Más vendidos" list |