Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
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_idExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANSAtributos 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/attributesExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA12345/attributesPesquisa de veículos
Com o recurso POST para /catalog_compatibilities/products_search/chunks e por meio dos atributos de domínio, é possível efetuar pesquisas que permitem:
- Obter os veículos disponíveis em nosso catálogo.
- Identificar os novos veículos que foram adicionados ao nosso catálogo.
- Identificar sugestões de compatibilidade.
Parâmetros:
Limit: parâmetro opcional, que indica o número de produtos a devolver. O valor padrão é = 50 e, caso seja informado, este valor não pode ser maior que 1000.
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.
Obter veículos disponíveis no nosso catálogo
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/chunksExemplo:
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.
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_valuesResposta:
[
{
"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_valuesResposta:
[
{
"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_valuesResposta:
[
{
"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.