Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 29/08/2024

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

Nota:
A partir de abril de 2024, o recurso POST foi disponibilizado para /catalog_compatibilities/products_search/chunks com o qual poderá igualar a experiência de busca de veículos a do nosso Gerenciador de compatibilidades (ABM) do Mercado Livre.

Com o recurso POST para /catalog_compatibilities/products_search/chunks e por meio dos atributos de domínio, é possível efetuar pesquisas que permitem:

  1. Obter os veículos disponíveis em nosso catálogo.
  2. Identificar os novos veículos que foram adicionados ao nosso catálogo.
  3. Identificar sugestões de compatibilidade.

Parâmetros:

Limit: parâmetro opcional, que indica o número de produtos a devolver. O valor maxímo é = 50.

Offset: parámetro opcional que indica el registro a partir del cuál se devolverán resultados. El valor por defecto es = 0.



Campos de resposta

Domain_id: obrigatório enviar para identificar as compatibilidades.

Site_id: obrigatório para indicar o sítio que procura.

Filter: atributo opcional para indicar qué productos se desean obtener. atributo opcional para indicar quais produtos deseja obter.

  • inserir o valor “NEW” retornaá os novos veículos recentemente adicionados ao catálogo.
  • ao indicar “SUGGESTED”, retornará a lista de veículos sugeridos para o item ou produto indicado.
  • se não for enviado nenhummvalor (vazio ou null), serão retornados todos os veículos (incluindo novos e sugeridos), tendo em conta os atributos de pesquisa.

Item_id: atributo obrigatório caso pretenda obter as sugestões do item. No caso de não enviar o item_id, são listadas todas as informações do secondary_product_id enviado.

Secondary_product_id: ID do produto associado ao item, é opcional, mas melhora o desempenho e os tempos de resposta utilizados (nos casos em que não seja enviado, será tomado do item).

Known_attributes: deve adicioná-los sempre com os seus "value_ids" e poderá colocar em formato de lista todas as opções que desejar.

Sort: este é um campo opcional que permite ordenar os resultados pelo atributo_id indicado. Por enquanto só é possível ordenar por BRAND por ordem ascendente ou descendente.


Tabela de atributos obrigatórios de acordo com a necessidade da pesquisa efectuada.

Atributo Obter os veículos disponíveis no nosso catálogo Identificar novos veículos Identificar sugestões
domain_id Obrigatório Obrigatório Obrigatório
site_id Obrigatório Obrigatório Obrigatório
item_id Opcional Opcional Opcional
secondary_product_id Opcional Opcional Opcional, mas no caso de ter este valor, sugere-se que o informe, pois ajuda a melhorar o desempenho do pedido.
known_attributes Opcional Opcional Opcional
Filter Não é necessário ser informado. “NEW” “SUGGESTED”
Sort Opcional Opcional Opcional

Campos da resposta

id: identificador del producto (vehículo).

attributes: arreglo de atributos del vehículo.

  • id: nombre del atributo del vehículo.
  • value_id: identificador valor asociado al atributo del vehículo.
  • value_name: valor asociado al atributo del vehículo.

filters: este atributo é uma lista que indica a que filtro pertence o produto, ou seja:

  • caso não seja enviado nenhum filtro no body, é indicado se o produto é novo ou sugerido ou ambos, por exemplo ( "filters": [“NEW", “SUGGESTED"] ); se o produto não pertença a nenhuma destas opções, é devolvida uma lista vazia ("filters": [] ).
  • no caso de enviar um filtro no body, o filtro selecionado no pedido é devolvido nessa lista, por exemplo, "filters": [“NEW"] ou "filters": [“SUGGESTED"].
  • value_name: valor associado ao atributo do veículo.

total: total de resultados que correspondem à pesquisa.



Utilizando os atributos do domínio, indicando-os em "known_attributes", poderá realizar a pesquiza para obter os veículos que estão disponíveis no nosso catálogo.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d 
{
 "domain_id": "MLB-CARS_AND_VANS",
 "site_id": "MLB",
 "known_attributes": [
     {
         "id": "BRAND",
         "value_ids": ["60249", "66432", "9909"]
     },
     {
         "id": "MODEL",
         "value_ids": ["389648", "17780469"]
     }
 ],
 "sort": {
     "attribute_id": "BRAND",
     "order": "desc"
 }
}
https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Resposta:

{
   "results": [
       {
           "id": "MLB22015088",
           "attributes": [
               {
                   "id": "BRAND",
                   "value_id": "60249",
                   "value_name": "Volkswagen"
               },
               {
                   "id": "MODEL",
                   "value_id": "389648",
                   "value_name": "Voyage"
               },
               {
                   "id": "VEHICLE_YEAR",
                   "value_id": "12023859",
                   "value_name": "2023"
               },
        .
.
.
{
                   "id": "CURRENCY",
                   "value_id": "10837729",
                   "value_name": "r$"
               }
           ],
           "filters": []
       },
       {
           "id": "MLB18230485",
           "attributes": [...],
           "filters": ["NEW"
]
       }
   ],
   "total": 180
}

Identificação de novos veículos

Para manter sempre actualizada a compatibilidade das suas publicações, com o seguinte recurso, indicando o atributo filter = "NEW" no request, poderá saber quais são os novos veículos que foram adicionados ao nosso catálogo a partir do 1º dia do mês anterior.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d 
{
 "domain_id": "MLB-CARS_AND_VANS",
 "site_id": "MLB",
 "known_attributes": [
     {
         "id": "BRAND",
         "value_ids": ["60249", "66432", "9909"]
     },
     {
         "id": "MODEL",
         "value_ids": ["389648", "17780469"]
     }
 ],
 "sort": {
     "attribute_id": "BRAND",
     "order": "desc"
 },
  "filter": "NEW"
}
https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Resposta:

{
   "results": [
       {
           "id": "MLB34236071",
           "attributes": [
               {
                   "id": "BRAND",
                   "name": "Marca",
                   "value_id": "66432",
                   "value_name": "Ford",
                   "values": [
                       {
                           "id": "66432",
                           "name": "Ford"
                       }
                   ]
               },
               {
                   "id": "MODEL",
                   "name": "Modelo",
                   "value_id": "17780469",
                   "value_name": "Corcel Ii",
                   "values": [
                       {
                           "id": "17780469",
                           "name": "Corcel Ii"
                       }
                   ]
               },
               {
                   "id": "CURRENCY",
                   "name": "Moeda",
                   "value_id": "10837729",
                   "value_name": "r$",
                   "values": [
                       {
                           "id": "10837729",
                           "name": "r$"
                       }
                   ]
               }
           ],
           "filters": [
               "NEW"
           ]
       }
   ],
   "total": 1
}

Identificar as compatibilidades sugeridas

Para manter as compatibilidades dos itens actualizadas e/ou caso identifique que um item possui a tag "pending_compatibilities" com o seguinte recurso (utilizando o atributo filter = "SUGGESTED") poderá saber quais são os veículos sugeridos para os items.


Lembre-se que dentro no request não é obrigatório informar o secondary_product_id, mas se o fizer ajudará a ter um melhor desempenho durante a petição.

Nota:
O secondary_product_id corresponde ao atributo catalog_product_id obtido quando se faz GET para /items/$ITEM_ID.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d 
{
 "domain_id": "MLB-CARS_AND_VANS",
 "site_id": "MLB",
 "item_id": "MLB4462690924",
 "secondary_product_id": "MLB31779615",
"known_attributes": [
     {
         "id": "BRAND",
         "value_ids": ["60297"]
     },
     {
         "id": "MODEL",
         "value_ids": ["389399"]
     }
 ],
 "sort": {
     "attribute_id": "BRAND",
     "order": "desc"
 },
 "filter": "SUGGESTED"
}

https://api.mercadolibre.com/catalog_compatibilities/products_search/chunks

Resposta:

{
   "results": [
       {
           "id": "MLB7866013",
           "attributes": [
               {
                   "id": "BRAND",
                   "name": "Marca",
                   "value_id": "60297",
                   "value_name": "Toyota",
                   "values": [
                       {
                           "id": "60297",
                           "name": "Toyota"
                       }
                   ]
               },
               {
                   "id": "MODEL",
                   "name": "Modelo",
                   "value_id": "389399",
                   "value_name": "Bandeirante",
                   "values": [
                       {
                           "id": "389399",
                           "name": "Bandeirante"
                       }
                   ]
               },
.
.
.
               {
                   "id": "CURRENCY",
                   "name": "Moeda",
                   "value_id": "10837729",
                   "value_name": "r$",
                   "values": [
                       {
                           "id": "10837729",
                           "name": "r$"
                       }
                   ]
               }
           ],
           "filters": [
               "SUGGESTED"
           ]
       }
   ],
   "total": 293
}

Para saber como identificar itens que têm sugestões de compatibilidade, pode ver mais detalhes em identificar itens com sugestões de compatibilidade.



Posibles errores:

Error_code Mensagem de erro Descrição
400 There is no configured compatibility for the category $categoryId A categoria consultada não está habilitada a comunicar compatibilidades.
401 Invalid access token. Access Token inválido.
403 Domain is not active. Domínio inativo em buybox.

400: formato incorreto/mais de 200 produtos para o domínio especificado / mais de 10 domínios especificados.

403: token inválido ou falta de permissões para o item.

404: o item ou a compatibilidade não existe.


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.