Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 01/11/2023

Domains, products and attributes vehicle accessories references

Nota:
As of September 27 with the GET resource to /catalog_compatibilities/products_search/new you will be able to find out which vehicles were added to the catalog in the last 30 days.

Available domains

Country Domain
ARGENTINA MLA-CARS_AND_VANS
BRASIL MLB-CARS_AND_VANS
MÉXICO MLM-CARS_AND_VANS_FOR_COMPATIBILITIES
URUGUAY MLU-CARS_AND_VANS
CHILE MLC-CARS_AND_VANS_FOR_COMPATIBILITIES

Main attributes

Attributes description Attributes of CARS_AND_VANS (MLA, MLB and MLU) Attributes of CARS_AND_VANS_FOR_COMPATIBILITIES (MLM and MLC)
BRAND BRAND BRAND
MODEL MODEL CAR_AND_VAN_MODEL
YEAR VEHICLE_YEAR YEAR
TRIM SHORT_VERSION CAR_AND_VAN_SUBMODEL

Secondary attributes

Attributes description Atributos de CARS_AND_VANS (MLA, MLB and MLU) Attributes of CARS_AND_VANS_FOR_COMPATIBILITIES (MLM and MLC)
ENGINE ENGINE CAR_AND_VAN_ENGINE
VEHICLE BODY VEHICLE_BODY_TYPE CAR_AND_VAN_BODY_TYPE
TRANSMISSION TRANSMISSION_CONTROL_TYPE TRANSMISSION_CONTROL_TYPE
TRANSMISSION TRANSMISSION CAR_AND_VAN_TRANSMISSION_TYPE
DRIVE TYPE DRIVE_TYPE DRIVE_TYPE
FUEL TYPE FUEL_TYPE FUEL_TYPE

Attributes by domain

Remember that the detail of the attributes of each Domain can be achieved with the following request:

curl -X GET --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$domain_id

Example:

curl -X GET --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS

Attributes by category

The detail of the attributes of each category can be achieved with the following request:

curl -X GET --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/:CATEGORY_ID/attributes

Example:

curl -X GET --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA12345/attributes

Through domain attributes, you can identify catalog products. For more information check the Catalog products search resource.

Example all sites (except MLM):

curl --location --request POST 'https://api.mercadolibre.com/products/search \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "domain_id": "MLA-CARS_AND_VANS",
   "site_id": "MLA",
   "attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       },
       {
           "id": "VEHICLE_YEAR",
           "value_id": "6730991"
       },
       {
           "id": "MODEL",
           "value_id": "1252874"
       },
       {
          "id": "SHORT_VERSION",
          "value_id": "2164329"
       }
   ]
}'

Response:

{
    "domain_id": "MLA-CARS_AND_VANS",
    "paging": {
        "total": 1,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA15520719",
            "status": "inactive",
            "domain_id": "MLA-CARS_AND_VANS",
            "name": "Volkswagen Gol Trend 1.6 Serie 101cv 5p 2020",
            "attributes": [...
            ],
            "pictures": []
        }
    ]
}

MLM example:

curl --location --request POST 'https://api.mercadolibre.com/products/search \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "domain_id":"MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
   "site_id":"MLM",
   "attributes":  [
        {
            "id": "BRAND",
            "value_id": "60249"
        },
        {
             "id": "YEAR",
            "value_id": "64314"
        },
        {
            "id": "CAR_AND_VAN_MODEL",
            "value_id": "8237019"
        }
   ]
}'

Response:

{
    "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
    "paging": {
        "total": 1,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLM15858556",
            "status": "inactive",
            "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
            "settings": {
                "listing_strategy": "open"
            },
            "name": "Volkswagen Sedan 1964 Base",
            "attributes": [...
            ],
            "pictures": []
        }
    ]
}

Obtain new products from the catalog

In order to always keep the compatibility of your listings updated, with the following resource you will be able to know which new vehicles have been added to the catalog in the last 30 days.


Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=$CATEGORY_ID

Query Params

  • categoryId
  • filterParents
  • limit

Request example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=MLA1234

Response example:

[
     {
         "id": "MLB25867468",
          "attributes": [
           {
                    "id": "BRAND",
                     "name": "Marca",
                     "value_id": "60285",
                    "value_name": "Subaru",
                    "values": [
                           {
                             "id": "60285",
                              "name": "Subaru"
                          }
                      ]
            } ], 
           "date_created": "2023-08-08T20:08:28Z"
   },
   {      
         "id": "MLB25867467",
          "attributes": [
           {
                    "id": "BRAND",
                     "name": "Marca",
                     "value_id": "60285",
                    "value_name": "Subaru",
                    "values": [
                           {
                             "id": "60285",
                              "name": "Subaru"
                          }
                      ]
            } ], 
           "date_created": "2023-08-09T20:08:28Z"
   }
]

Parameters:

categoryId: Required parameter, where they must send a category that has the compatibilities experience enabled.

filterParents: Optional parameter that indicates whether to filter parent products or not, if you want to get all products including parents you must send false. Its default value is true.

limit: Optional parameter that indicates the number of products to return, if you want to get all products you must send zero (0). Its default value is 10.



Possible errors:

Error_code Error message Description
400 There is no configured compatibility for the category $categoryId The consulted category is not enabled to report compatibilities.
401 Invalid access token. Access Token invalid.
403 Domain is not active. Dominio inactive in buybox.

400: Incorrect format / more than 200 products for the specified domain / more than 10 domains specified.

403: Invalid token or lack of permissions on the item.

404: Item or compatibility does not exist.


Top values

Now you can see how to implement the functionality of obtaining different lists with attribute values through the Top values feature and filter the results.
With the following feature you can obtain the values of each combination and refine the search each time.

Request:

curl -X POST --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values 

"BRAND" example:

curl -X POST --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/BRAND/top_values

Response:

[
   {
       "id": "60249",
       "name": "Volkswagen",
       "metric": 7781
   },
   {
       "id": "66432",
       "name": "Ford",
       "metric": 5616
   },
   {
       "id": "9909",
       "name": "Renault",
       "metric": 4327
   },
   {
       "id": "60279",
       "name": "Peugeot",
       "metric": 4250
   },
   {
       "id": "67781",
       "name": "Fiat",
       "metric": 4172
   },
[…]
]

Example to filter models (MODEL) of a brand (BRAND):

curl -X POST --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/MODEL/top_values 
{
   "known_attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       }
   ]
}

Response:

[
   {
       "id": "63686",
       "name": "Amarok",
       "metric": 1516
   },
   {
       "id": "1252874",
       "name": "Gol Trend",
       "metric": 925
   },
   {
       "id": "62109",
       "name": "Gol",
       "metric": 684
   },
   {
       "id": "1252871",
       "name": "Suran",
       "metric": 604
   },
   {
       "id": "64016",
       "name": "Vento",
       "metric": 585
   },
…
]

Example to get the available years (VEHICLE_YEAR) filtering by brand and model:

curl -X POST --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/VEHICLE_YEAR/top_values
{
   "known_attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       },
       {
           "id": "MODEL",
           "value_id": "63686"
       }
   ]
}

Response:

[
   {
       "id": "6730991",
       "name": "2020",
       "metric": 732
   },
   {
       "id": "423549",
       "name": "2015",
       "metric": 130
   },
   {
       "id": "436694",
       "name": "2017",
       "metric": 115
   },
   {
       "id": "2451646",
       "name": "2019",
       "metric": 104
   },
[…]
]

Back to: Compatibility between items and vehicle accessories.