Domains, products and attributes vehicle accessories references

Contents

→Attributes by domain
→Attributtes by category
→Product search
→Top values


Available domains

Country Domain
ARGENTINA MLA-CARS_AND_VANS
BRASIL MLB-CARS_AND_VANS
MÉXICO MLM-CARS_AND_VANS_FOR_COMPATIBILITIES

Main attributes (PARENT_PK)

Attributes description América Latina´s attributes (except México) México´s attributes
MARCA BRAND BRAND
MODELO MODEL CAR_AND_VAN_MODEL
ANO VEHICLE_YEAR YEAR
SUBMODELO TRIM CAR_AND_VAN_SUBMODEL

Secondary attributes(CHILD_PK)

Attributes description América Latina´s attributes (except México) México´s attributes
MOTOR ENGINE CAR_AND_VAN_ENGINE
CARROÇARIA VEHICLE_BODY_TYPE CAR_AND_VAN_BODY_TYPE
TRANSMISSÃO TRANSMISSION_CONTROL_TYPE TRANSMISSION_CONTROL_TYPE
TIPO DE TRANSMISSÃO TRANSMISSION CAR_AND_VAN_TRANSMISSION_TYPE
TIPO DE TRAÇÃO DRIVE_TYPE DRIVE_TYPE
TIPO DE COMBUSTÍVEL 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": "TRIM",
           "value_id": "2228234"
       }
   ]
}'

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": []
        }
    ]
}

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 aavailable 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.

or register to recieve the latest news about our API