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

Conteúdos

→Atributos por domínio
→Atributos por categoria
→Product search
→Top values


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

Atributos principais (PARENT_PK)

Descrição dos atributos Atributos da América Latina (exceto México) Atributos de México
MARCA BRAND BRAND
MODELO MODEL CAR_AND_VAN_MODEL
ANO VEHICLE_YEAR YEAR
SUBMODELO TRIM CAR_AND_VAN_SUBMODEL

Atributos secundários (CHILD_PK)

Descrição dos atributos Atributos de Latam (excepto México) Atributos de México
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

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 --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$domain_id

Exemplo:

curl -X GET --header '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 --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/:CATEGORY_ID/attributes

Exemplo:

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

Por meio dos atributos do domínio, você pode identificar produtos de catálogo. Para mais informações consulte o recurso Buscador de produtos.

Exemplo all sites (exceto 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"
       }
   ]
}'

Resposta:

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

Exemplo 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":"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

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 --header 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values 

Exemplo "BRAND":

curl -X POST --header '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 --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"
       }
   ]
}

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

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.

ou registre-se para receber as últimas notícias sobre nossa API