Referências de domínios, produtos e atributos para Autopeças

Domínios disponíveis

País	Domínio
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
COLOMBIA	MCO-CARS_AND_VANS_FOR_COMPATIBILITIES

De acordo com o domínio do sítio,Sugerimos que dentro do seu gerenciador de compatibilidade você habilite os filtros primários, secundários e opcionais,como é mostrado a seguir.

Exemplo de atributos utilizados no motor de busca de compatibilidade para veículos do domínio CARS_AND_VANS que se aplica aos sítios MLA, MLB e MLU.

Exemplo de atributos utilizados no buscador de compatibilidade de veículos do domínio CARS_AND_VANS_FOR_COMPATIBILITIES que se aplica aos sites MLM, MLC e MCO.

Atributos principais

Descrição dos atributos	Atributos de de CARS_AND_VANS (MLA, MLB y MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM, MLC y MCO)
MARCA	BRAND	BRAND
MODELO	MODEL	CAR_AND_VAN_MODEL
ANO	VEHICLE_YEAR	YEAR
VERSIÓN	SHORT_VERSION	CAR_AND_VAN_SUBMODEL
MOTOR	ENGINE	CAR_AND_VAN_ENGINE

Atributos secundários

Descrição dos atributos	Atributos de CARS_AND_VANS (MLA, MLB y MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC)
COMBUSTIBLE	FUEL_TYPE	N/A
POTENCIA	POWER	N/A
CARROÇARIA	VEHICLE_BODY_TYPE	N/A
TRANSMISSÃO	TRANSMISSION_CONTROL_TYPE	N/A

Atributos opcionais

Descrição do atributo	Atributos de CARS_AND_VANS (MLA, MLB y MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM, MLC y MCO)
MARCHAS	GEAR_NUMBER	CAR_AND_VAN_ENGINE
PORTAS	DOORS	N/A
ENDEREÇO	STEERING	N/A
TRAÇÃO	TRACTION_CONTROL	N/A
VÁLVULAS	VALVES_PER_CYLINDER	N/A
SISTEMA DE DIREÇÃO	N/A	STEERING_SYSTEM
TIPO DE ENDEREÇO	N/A	STEERING_TYPE
TIPO DE TRAÇÃO	N/A	DRIVE_TYPE
CARROÇARIA	N/A	CAR_AND_VAN_BODY_TYPE
TIPO DE CONTROLE DE TRANSMISSÃO	N/A	TRANSMISSION_CONTROL_TYPE
NÚMERO DE VELOCIDADES DE TRANSMISSÃO	N/A	TRANSMISSION_SPEEDS_NUMBER
NÚMERO DE PORTAS	N/A	BODY_DOORS_NUMBER
FREIOS ABS	N/A	BRAKE_ABS

Atributos por domínio

Lembre-se que o detalhe dos atributos de cada domínio pode ser conseguido com a seguinte chamada:

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

Exemplo:

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

Atributos por categoria

O detalhe dos atributos de cada categoria pode ser conseguido com a seguinte chamada:

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

Exemplo:

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

Pesquisa de veículos

A partir de 15/07/2026, o recurso POST /catalog_compatibilities/products_search/chunks não está mais disponível.

Para gerenciar as compatibilidades das publicações, utilize as alternativas detalhadas a seguir.

1. Identificar publicações com compatibilidades sugeridas pendentes — utilize a tag pending_compatibilities:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$SELLER_ID/items/search?tags=pending_compatibilities'

2. Identificar publicações com compatibilidades incompletas — utilize a tag incomplete_compatibilities:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$SELLER_ID/items/search?tags=incomplete_compatibilities'

3. Gerenciar o catálogo de veículos e aplicar sugestões — utilize o Gerenciador de Compatibilidades no Mercado Livre diretamente.

Top values

Agora você pode ver como implementar por meio do recurso Top values a funcionalidade de conseguir listas diferentes com valores de atributos e filtrar os resultados.
Com o seguinte recurso você pode obter os valores de cada combinação e refinar a pesquisa a cada vez.

Chamada:

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

Exemplo "BRAND":

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

Resposta:

[
   {
       "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
   },
[…]
]

Exemplo para filtrar modelos (MODEL) de uma marca (BRAND):

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

Resposta:

[
   {
       "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
   },
…
]

Exemplo para obter os anos disponíveis (VEHICLE_YEAR) filtrando por marca e modelo:

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

Resposta:

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

Voltar: Compatibilidades entre itens e produtos de Autopeças.