Mais vendidos no Mercado Livre

Atualize sua integração com o recurso /highlights para consultar a listagem dos 20 produtos mais vendidos do Mercado Livre. Você pode verificá-los de acordo com a categoria, marca, produto e / ou item.



Conteúdos

→Mais vendidos por categoria →Mais vendidos por categoria e atributo marca →Posicionamento do produto →Posicionamento do item →Erros

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_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/category/MLB432825

Resposta:

{
    "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=59387

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLA/category/MLA1055?attribute=BRAND&attributeValue=59387

Resposta:

{
    "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_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLB/product/MLB15960724

Resposta:

{
    "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_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/highlights/MLM/item/MLM16140709

Resposta:

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

ou registre-se para receber as últimas notícias sobre nossa API