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
→Productos por dominios
→Producto por ID

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/catalog/dumps/domains/$SITE_ID/standard

Ejemplo:

curl -X GET https://api.mercadolibre.com/catalog/dumps/domains/MLA/standard
Respuesta:

[
  {
    "id": "MLA-CELLPHONE_USB_AND_AUXILIARY_ADAPTERS",
    "name": "Adaptadores de USB y auxiliar para celulares",
    "numeric_id": 2,
    "multisite_catalog": true,
    "is_generic": false,
    "checked_categories": false,
    "catalogable": "NOT_DEFINED",
    "date_created": "2014-06-09T22:46:01Z",
    "domain_structure_last_updated": "2020-07-03T16:25:48Z",
    "apd_last_updated": "2020-07-03T16:25:48Z",
    "products_last_updated": "2020-07-01T04:08:11Z",
    "last_updated": "2020-07-03T16:25:48Z",
    "pictures": [
      {
        "id": "715173-MLU30701120250_052019",
        "url": "http://http2.mlstatic.com/D_NQ_NP_715173-MLU30701120250_052019-F.jpg",
        "secure_url": "https://http2.mlstatic.com/D_NQ_NP_715173-MLU30701120250_052019-F.jpg",
        "size": "500x500"
      }
    ],
    "metadata": {
      "business_unit": "core",
      "vertical": "consumer_electronics"
    }
  },


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.