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
Product search
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.