Domains and Products

The new domain resource allows you to know the set of products that share common characteristics to create listings with all the necessary information and offer a good platform user experience. It will also help you be part of Catalogue.
Start using it now!

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.
or register to recieve the latest news about our API