Dominios y Productos

El nuevo recurso de dominios te permitirá conocer el conjunto de productos que comparten características en común para así poder crear publicaciones con toda la información necesaria y ofrecer una buena experiencia a los usuarios de la plataforma. Además, te ayudará para poder formar parte de Catálogo. ¡Empieza a utilizarlo ahora!


Contenidos


Dominios por país

El ID del dominio es compartido por todos los países y difiere en cada uno de estos por el prefijo, por ejemplo: el prefijo para Mercado Libre Argentina es MLA. Para conocer los ID por país, realiza la siguiente consulta al recurso Domains.

Llamada:

curl -X GET https://api.mercadolibre.com/sites/{site_id}/domains

Ejemplo:

curl -X GET https://api.mercadolibre.com/sites/MLA/domains

Respuesta:

[
  {
    "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"
  },


Productos por dominios

Para conocer cuáles son los productos que están asociados a un dominio, puedes hacer la consulta al recurso /catalog_domains/<domains_id>/products.

Llamada:

curl -X GET https://api.mercadolibre.com/catalog_domains/{domain_id}/products

Ejemplo:

curl -X GET https://api.mercadolibre.com/catalog_domains/MLA-MICROWAVES/products

Respuesta:

[
  {
    "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"
  },


Producto por ID

Una vez identificado el producto dentro del dominio, puedes conocer sus características principales con el recurso /products/{product_id}. De esta manera, será posible crear un ítem de mejor calidad.

Llamada

curl -X GET https://api.mercadolibre.com/products/{product_id}

Ejemplo

curl -X GET https://api.mercadolibre.com/products/MLA10025564

Respuesta

{
  "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": [
  ]
}

Comportamientos especiales:

  • Cuando el producto cuenta con "status": "inactive" los campos “pictures”, "pickers" y "main_features" vendrán con null. Y los campos dentro de "short_description" vienen vacios.

  • El campo de "buy_box_winner" indica el ítem de catálogo que actualmente tiene la buybox "ganada". Cuando no hay ningún item de catálogo compitiendo por la buybox para este producto, este campo viene en null.