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.

Forma parte de nuestra comunidad