Last update 07/06/2022

Best sellers in Mercado Libre

Update your integration with the /highlights resource to consult the 20 "Más vendidos" products list in Mercado Libre. You can check them according to the category, brand, product and/or item.



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_ID

Example:

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

Response:

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

Example:

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

Response:

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

Example:

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

Response:

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

Example:

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

Response:

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