Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Última atualização em 14/03/2023
Mais vendidos no Mercado Livre
Mais vendidos por categoria
Você pode consultar os 20 principais itens/produtos de uma categoria específica.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/category/$CATEGORY_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/category/MLB432825Resposta:
{
"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"
}
]
}Campos da resposta
query_data: informações sobre o tipo de filtro aplicado
content:
- id: id do item ou produto
- position: posicionamento na listagem
- type: tipo de elemento (ítem/product)
Mais vendidos por categoria e atributo marca
Você pode obter os 20 principais itens/produtos de uma marca em uma categoria específica.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/category/$CATEGORY_ID?attribute=BRAND&attributeValue=59387Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLA/category/MLA1055?attribute=BRAND&attributeValue=59387Resposta:
{
"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"
}
]
}Posicionamento do producto
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/product/$PRODUCT_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/product/MLB15960724Resposta:
{
"dimension": "category",
"id": "MLB1055",
"label": "Celulares e Smartphones",
"position": 19
}Posicionamento do item
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/$SITE_ID/item/$ITEM_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLM/item/MLM16140709Resposta:
{
"dimension": "category",
"id": "MLM126793",
"label": "Smartwatches",
"position": 5
}Campos da resposta
dimension: critério usado (category)
- id: id do dimension
- label: título da dimension
- position: posicionamento do produto ou item (segundo a chamada) na listagem
Erros
| Erro | Descrição | Solução |
|---|---|---|
| 400 | Erro site: ML | Envie site_id valido |
| 400 | Invalid product id MLB | Envie product/item_id valido |
| 401 | unspecified_token | Envie access token valido |
| 404 | item/product with id MLB15960724 not found | O item/produto não está listado nos Mais vendidos |
| 404 | Dimension CATEGORY with id MLB432825 not found | A categoria não tem listagem dos Mais vendidos |