Mais vendidos no Mercado Livre

Mais vendidos por categoria

Consulte 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": "MLBU3013800008",
            "position": 1,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU3981133472",
            "position": 2,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU4039073621",
            "position": 3,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU3021966048",
            "position": 4,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU3969242429",
            "position": 5,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLB24162817",
            "position": 6,
            "type": "PRODUCT"
        },
        {
            "id": "MLBU4035041691",
            "position": 7,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLB47622621",
            "position": 8,
            "type": "PRODUCT"
        },
        {
            "id": "MLBU3981122876",
            "position": 9,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLB24723692",
            "position": 10,
            "type": "PRODUCT"
        },
        {
            "id": "MLB70334862",
            "position": 11,
            "type": "PRODUCT"
        },
        {
            "id": "MLBU670601037",
            "position": 12,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU3986388996",
            "position": 13,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU1966388133",
            "position": 14,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLBU3440726552",
            "position": 15,
            "type": "USER_PRODUCT"
        },
        {
            "id": "MLB6868664726",
            "position": 16,
            "type": "ITEM"
        },
        {
            "id": "MLB61695785",
            "position": 17,
            "type": "PRODUCT"
        },
        {
            "id": "MLB70659272",
            "position": 18,
            "type": "PRODUCT"
        },
        {
            "id": "MLB41966415",
            "position": 19,
            "type": "PRODUCT"
        },
        {
            "id": "MLB2064796357",
            "position": 20,
            "type": "PRODUCT"
        }
    ]
}

Campos da resposta

• query_data: informações sobre o filtro aplicado na consulta.
• highlight_type: tipo de ranking. Valor fixo: BEST_SELLER.
• criteria: critério utilizado. Valor: CATEGORY.
• id: ID da categoria consultada.
• content: lista de até 20 elementos mais vendidos.
• id: identificador do elemento. O prefixo varia conforme o tipo (MLB, MLA, MLBU, etc.).
• position: posição no ranking (1 = mais vendido).
• type: tipo do elemento. Valores possíveis:
  • ITEM: publicação individual sem catálogo associado.
  • PRODUCT: produto do catálogo oficial do Mercado Livre.
  • USER_PRODUCT: produto criado por um vendedor (catálogo de usuário). O ID utiliza o prefixo MLBU.

Mais vendidos por categoria e atributo marca

Obtenha os 20 principais itens/produtos de uma marca específica dentro de uma categoria. Use os parâmetros attribute e attributeValue para filtrar por qualquer atributo suportado.

Query parameters

• attribute (obrigatório): nome do atributo pelo qual filtrar. Exemplo: BRAND.
• attributeValue (obrigatório): ID do valor do atributo. Exemplo: 59387.

Chamada:

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

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": "MLA55323897",
            "position": 1,
            "type": "PRODUCT"
        },
        {
            "id": "MLA65759096",
            "position": 2,
            "type": "PRODUCT"
        },
        {
            "id": "MLA45818964",
            "position": 3,
            "type": "PRODUCT"
        },
        {
            "id": "MLA46219511",
            "position": 4,
            "type": "PRODUCT"
        }
    ]
}

Posicionamento do produto

Consulte em qual posição um produto se encontra no ranking dos mais vendidos e em qual categoria ou dimensão ele está ranqueado.

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/MLA/product/MLA55323897

Resposta:

{
    "dimension": "attributes",
    "id": "MLA1055-BRAND-59387",
    "label": "Celulares y Smartphones Xiaomi",
    "position": 1
}

Campos da resposta

• dimension: critério pelo qual o produto foi ranqueado. Valores possíveis:
  • category: o produto está no top de uma categoria.
  • attributes: o produto está no top de uma categoria filtrada por atributo (ex.: marca).
• id: identificador da dimensão.
  • Se dimension = category: ID da categoria (ex.: MLA1055).
  • Se dimension = attributes: ID composto no formato {CATEGORY_ID}-{ATTRIBUTE}-{VALUE_ID} (ex.: MLA1055-BRAND-59387).
• label: nome descritivo da dimensão (ex.: nome da categoria ou categoria + marca).
• position: posição do produto no ranking dessa dimensão.

Posicionamento do item

Consulte em qual posição uma publicação (item) se encontra no ranking dos mais vendidos.

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/MLB/item/MLB6868664726

Resposta:

{
    "dimension": "category",
    "id": "MLB270287",
    "label": "Geladeiras",
    "position": 12
}

Campos da resposta

• dimension: critério pelo qual o item foi ranqueado. Valor: category.
• id: ID da categoria em que o item está ranqueado.
• label: nome da categoria.
• position: posição do item no ranking dessa categoria.

Erros