Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Referencias de dominios, productos y atributos para Autopartes
Dominios disponibles
País | Dominio |
---|---|
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 principales
Descripción de atributos | Atributos de CARS_AND_VANS (MLA, MLB, MLU) | Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC) |
---|---|---|
MARCA | BRAND | BRAND |
MODELO | MODEL | CAR_AND_VAN_MODEL |
AÑO | VEHICLE_YEAR | YEAR |
VERSIÓN | SHORT_VERSION | CAR_AND_VAN_SUBMODEL |
Atributos secundarios
Descripción de 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 |
CARROCERÍA | VEHICLE_BODY_TYPE | CAR_AND_VAN_BODY_TYPE |
TRANSMISIÓN | TRANSMISSION_CONTROL_TYPE | TRANSMISSION_CONTROL_TYPE |
TIPO DE TRANSMISIÓN | TRANSMISSION | CAR_AND_VAN_TRANSMISSION_TYPE |
TIPO DE TRACCIÓN | DRIVE_TYPE | DRIVE_TYPE |
TIPO DE COMBUSTIBLE | FUEL_TYPE | FUEL_TYPE |
Atributos por dominio
Recuerda que el detalle de los atributos por cada dominio lo puedes obtener con la siguiente llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS
Atributos por categoría
Recuerda que el detalle de los atributos por cada categoría lo puedes obtener con la siguiente llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA12345/attributes
Product search
Por medio de los atributos del dominio puedes identificar productos de catálogo. Para más información consulta el recurso Buscador de productos.
Ejemplo all sites (excepto 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
Respuesta:
{
"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": []
}
]
}
Ejemplo 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
Respuesta:
{
"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": []
}
]
}
Obtener los productos nuevos del catálogo
Para poder mantener actualizadas siempre las compatibilidades de tus publicaciones, con el siguiente recurso podrás conocer cuáles son los vehículos nuevos que fueron agregados al catálogo en los últimos 30 días.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=$categoryId
Query Params
- categoryId
- filterParents
- limit
Ejemplo llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=MLA1234
Ejemplo respuesta:
[
{
"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 requerido, donde deben enviar una categoría que tenga habilitada la experiencia de compatibilidades.
filterParents: parámetro opcional que indica si filtra productos padres o no, si desean obtener todos los productos incluyendo padres deben enviar false. Su valor por defecto es true.
limit: parámetro opcional que indica la cantidad de productos a devolver, si desean obtener todos los productos deben enviar cero (0). Su valor por defecto es de 10 .
Posibles errores:
Error_code | Mensaje del error | Descripción |
---|---|---|
400 | There is no configured compatibility for the category $categoryId | La categoría consultada no está habilitada para informar compatibilidades. |
401 | Invalid access token. | Access Token inválido. |
403 | Domain is not active. | Dominio inactivo en buybox. |
400: formato incorrecto / más de 200 productos para el dominio especificado / más de 10 dominios especificados.
403: token inválido o falta de permisos sobre el ítem.
404: el ítem o la compatibilidad no existen.
Top values
A continuación puedes ver cómo implementar por medio del recurso Top values la funcionalidad para cargar distintas listas con valores de atributos e ir filtrando los resultados.
Con el siguiente recurso se pueden obtener los valores de cada combinación e ir refinando cada vez la búsqueda.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values
Ejemplo "BRAND":
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/BRAND/top_values
Respuesta:
[
{
"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
},
[…]
]
Ejemplo para filtrar modelos (MODEL) de una marca (BRAND):
curl -X POST -H '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"
}
]
}
Respuesta:
[
{
"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
},
…
]
Ejemplo para obtener los años disponibles (VEHICLE_YEAR) filtrando por marca y modelo:
curl -X POST -H '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"
}
]
}
Respuesta:
[
{
"id": "6730991",
"name": "2020",
"metric": 732
},
{
"id": "423549",
"name": "2015",
"metric": 130
},
{
"id": "436694",
"name": "2017",
"metric": 115
},
{
"id": "2451646",
"name": "2019",
"metric": 104
},
[…]
]
Volver: Compatibilidades entre ítems y productos de Autopartes.