Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação
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 |
Atributos principais
Descrição dos atributos | Atributos de de CARS_AND_VANS (MLA, MLB y MLU) | Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC) |
---|---|---|
MARCA | BRAND | BRAND |
MODELO | MODEL | CAR_AND_VAN_MODEL |
ANO | VEHICLE_YEAR | YEAR |
VERSIÓN | SHORT_VERSION | CAR_AND_VAN_SUBMODEL |
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) |
---|---|---|
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 -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
Product search
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 -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d
{
"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": "SHORT_VERSION",
"value_id": "2164329"
}
]
}
https://api.mercadolibre.com/products/search
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 -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -h 'Content-Type: application/json' -d
{
"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"
}
]
}
https://api.mercadolibre.com/products/search
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": []
}
]
}
Obter novos produtos do catálogo
Para manter atualizadas as compatibilidades das suas publicações, o seguinte recurso permitesaber quais são os novos veículos que foram acrescentados ao catálogo nos últimos 30 dias.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=$categoryId
Query Params
- categoryId
- filterParents
- limit
Exemplo chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=MLA1234
Exemplo resposta:
[
{
"id": "MLB25867468",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "60285",
"value_name": "Subaru",
"values": [
{
"id": "60285",
"name": "Subaru"
}
]
} ],
"date_created": "2023-08-08T20:08:28Z"
},
{
"id": "MLB25867467",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "60285",
"value_name": "Subaru",
"values": [
{
"id": "60285",
"name": "Subaru"
}
]
} ],
"date_created": "2023-08-09T20:08:28Z"
}
]
Parâmetros:
categoryId: parâmetro obrigatório, onde devem enviar uma categoria que tenha a experiência de compatibilidades ativada.
filterParents: parâmetro opcional que indica se devem ou não ser filtrados os produtos pais; se pretender obter todos os produtos, incluindo os pais, deve enviar false. O seu valor predefinido é true.
limit: parâmetro opcional que indica o número de produtos a devolver, se pretender obter todos os produtos deve enviar zero (0). Seu valor padrão é 10.
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.