Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
Última actualización 07/07/2020
Domains and Products
Contents
→Domains by country
→Products by domain
→Products by ID
↳Special behaviors
Domains by country
The domain ID is shared by every country, but each country has a different prefix, e.g., Mercado Libre prefix in Argentina is MLA. To know IDs by country, perform the following query to the Domains resource.
Request:
curl -X GET https://api.mercadolibre.com/sites/{site_id}/domains
Example:
curl -X GET https://api.mercadolibre.com/sites/MLA/domains
Response:
[
{
"id": "MLA-3D_GLASSES",
"name": "Lentes 3D"
},
{
"id": "MLA-3D_PENS",
"name": "Lápices 3D"
},
{
"id": "MLA-3D_PRINTERS",
"name": "Impresoras 3D"
},
{
"id": "MLA-3D_PRINTER_FILAMENTS",
"name": "Filamentos para impresora 3D"
},
{
"id": "MLA-3D_PRINTER_HEATBEDS",
"name": "Camas calientes para impresoras 3D"
},
{
"id": "MLA-3D_PRINTER_HOTENDS",
"name": "Hotends para impresoras 3D"
},
{
"id": "MLA-3D_PRINTER_NOZZLES",
"name": "Nozzles para impresoras 3D"
},
{
"id": "MLA-3D_PRINTER_THERMISTORS",
"name": "Termistores para impresoras 3D"
},
{
"id": "MLA-ABDOMINAL_TONING_BELTS",
"name": "Cinturones tonificadores para abdominales"
},
Products by domain
To know which products are associated to a domain, you can query resource /catalog_domains//products.
Request:
curl -X GET https://api.mercadolibre.com/catalog_domains/{domain_id}/products
Example:
curl -X GET https://api.mercadolibre.com/catalog_domains/MLA-MICROWAVES/products
Response:
[
{
"id": "MLA824561",
"domain_id": "MLA-MICROWAVES",
"name": "LG MB-4344B",
"children_ids": [
"MLA10821363"
],
"attributes": [],
"images": [
],
"last_updated": "2019-06-11T18:28:04Z"
},
{
"id": "MLA824567",
"domain_id": "MLA-MICROWAVES",
"name": "BGH Quick Chef 16260",
"children_ids": [
"MLA10821364"
],
"attributes": [],
"images": [
],
"last_updated": "2019-06-11T18:28:04Z"
},
{
"id": "MLA824569",
"domain_id": "MLA-MICROWAVES",
"name": "BGH Quick Chef 24560",
"children_ids": [
"MLA10821365"
],
"attributes": [],
"images": [
],
"last_updated": "2019-06-11T18:28:04Z"
},
{
"id": "MLA824571",
"domain_id": "MLA-MICROWAVES",
"name": "BGH Quick Chef 16360",
"children_ids": [
"MLA10821366"
],
"attributes": [],
"images": [
],
"last_updated": "2019-06-11T18:28:04Z"
},
Products by ID
Once the product inside the domain is identified, you may query its main characteristics with resource /products/{product_id}. This way, you will be able to create a better quality item.
Request:
curl -X GET https://api.mercadolibre.com/products/$PRODUCT_ID
Example:
curl -X GET https://api.mercadolibre.com/products/MLA10025564
Response:
{
"id": "MLA10025564",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"permalink": "https://www.mercadolibre.com.ar/p/MLA10025564",
"name": "Samsung Galaxy J4 Dual SIM 32 GB Púrpura",
"buy_box_winner": null,
"pickers": [
{
"picker_id": "INTERNAL_MEMORY",
"picker_name": "Memoria interna",
"products": [
{
"product_id": "MLA10025565",
"picker_label": "16 GB",
"picture_id": "",
"thumbnail": "",
"tags": [
"disabled"
],
"permalink": "https://www.mercadolibre.com.ar/p/MLA10025565"
}
]
}
],
"pictures": [
{
"id": "877438-MLA31001589974_062019",
"url": "https://mla-s1-p.mlstatic.com/877438-MLA31001589974_062019-F.jpg",
"suggested_for_picker": [
],
"max_width": 589,
"max_height": 1118
}
],
"main_features": [
{
"text": "Procesador Exynos 7570 Quad-core - 2 GB",
"type": "key_value",
"metadata": {
"key": "",
"value": ""
}
}
],
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "206",
"value_name": "Samsung"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "195973",
"value_name": "Galaxy J"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "5640181",
"value_name": "J4 Duos"
}
],
"short_description": {
"type": "plaintext",
"content": "El Galaxy J4 cuenta con una pantalla HD de 5.5” que te da un excelente radio de contraste con imágenes realistas...
},
"parent_id": "MLA9928419",
"children_ids": [
]
}
Special behaviors
- When the product "status" is: "inactive", “pictures”, "pickers" and "main_features" fields will be null. And "short_description" fields will be empty.
- The "buy_box_winner" field indicates the catalog item that has “won” the buybox. When there is no catalog item competing for the product buybox, this field is null.