Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade
Última actualización 15/03/2023

Categorías y Atributos


Las categorías son un conjunto jerárquico de grupos en los cuales se enumeran los publicaciones de naturaleza similar, denominados “Árbol de Categorías”. Las categorías ayudan a los usuarios a buscar fácilmente el tipo de publicación que desean. Cada sitio tiene su propio conjunto de categorías, es decir que Argentina tendrá un conjunto único de categorías, diferente de las que encontrarás en Brasil, porque cada país tiene sus propias particularidades en el mercado clasificados.
Antes de publicar una publicación, debes explorar la estructura de categorías y elegir en cuál deseas publicar. Para ayudarte, puedes descargar la jerarquía completa de categorías con ID y nombres fáciles desde nuestra API. Para publicar un inmueble, deberás seleccionar el category_id según el tipo de operación y propiedad.


Categorías por Site

El recurso Sites puede ofrecerte la estructura de categorías para un país en particular, en este caso Argentina.

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories

Respuesta:

[
    {
        "id": "MLA5725",
        "name": "Accesorios para Vehículos"
    },
    {
        "id": "MLA1512",
        "name": "Agro"
    },
    {
        "id": "MLA1403",
        "name": "Alimentos y Bebidas"
    },
    {
        "id": "MLA1071",
        "name": "Animales y Mascotas"
    },
    {
        "id": "MLA1367",
        "name": "Antigüedades y Colecciones"
    },
    {
        "id": "MLA1368",
        "name": "Arte, Librería y Mercería"
    },
    {
        "id": "MLA1743",
        "name": "Autos, Motos y Otros"
    },
    {
        "id": "MLA1384",
        "name": "Bebés"
    },
    {
        "id": "MLA1246",
        "name": "Belleza y Cuidado Personal"
    },
    {
        "id": "MLA1039",
        "name": "Cámaras y Accesorios"
    },
    {
        "id": "MLA1051",
        "name": "Celulares y Teléfonos"
    },
    {
        "id": "MLA1648",
        "name": "Computación"
    },
    {
        "id": "MLA1144",
        "name": "Consolas y Videojuegos"
    },
    {
        "id": "MLA1500",
        "name": "Construcción"
    },
    {
        "id": "MLA1276",
        "name": "Deportes y Fitness"
    },
    {
        "id": "MLA5726",
        "name": "Electrodomésticos y Aires Ac."
    },
    {
        "id": "MLA1000",
        "name": "Electrónica, Audio y Video"
    },
    {
        "id": "MLA2547",
        "name": "Entradas para Eventos"
    },
    {
        "id": "MLA407134",
        "name": "Herramientas"
    },
    {
        "id": "MLA1574",
        "name": "Hogar, Muebles y Jardín"
    },
    {
        "id": "MLA1499",
        "name": "Industrias y Oficinas"
    },
    {
        "id": "MLA1459",
        "name": "Inmuebles"
    },
    {
        "id": "MLA1182",
        "name": "Instrumentos Musicales"
    },
    {
        "id": "MLA3937",
        "name": "Joyas y Relojes"
    },
    {
        "id": "MLA1132",
        "name": "Juegos y Juguetes"
    },
    {
        "id": "MLA3025",
        "name": "Libros, Revistas y Comics"
    },
    {
        "id": "MLA1168",
        "name": "Música, Películas y Series"
    },
    {
        "id": "MLA1430",
        "name": "Ropa y Accesorios"
    },
    {
        "id": "MLA409431",
        "name": "Salud y Equipamiento Médico"
    },
    {
        "id": "MLA1540",
        "name": "Servicios"
    },
    {
        "id": "MLA9304",
        "name": "Souvenirs, Cotillón y Fiestas"
    },
    {
        "id": "MLA1953",
        "name": "Otras categorías"
    }
]

Para categorías de segundo nivel o información relacionada con categorías específicas, debes utilizar el recurso Categorías y enviar el ID de categoría como parámetro URL.

Veamos qué encontramos en la categoría "Inmuebles".


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1459

Respuesta:

{
    "id": "MLA1459",
    "name": "Inmuebles",
    "picture": "http://resources.mlstatic.com/category/images/cc0eed64-9cfb-4b78-9258-6266475f6427.png",
    "permalink": "https://www.mercadolibre.com.ar/c/inmuebles",
    "total_items_in_this_category": 652169,
    "path_from_root": [
        {
            "id": "MLA1459",
            "name": "Inmuebles"
        }
    ],
    "children_categories": [
        {
            "id": "MLA374730",
            "name": "Camas Náuticas",
            "total_items_in_this_category": 319
        },
        {
            "id": "MLA1496",
            "name": "Campos",
            "total_items_in_this_category": 5789
        },
        {
            "id": "MLA1466",
            "name": "Casas",
            "total_items_in_this_category": 172797
        },
        {
            "id": "MLA50541",
            "name": "Cocheras",
            "total_items_in_this_category": 9817
        },
        {
            "id": "MLA392265",
            "name": "Consultorios",
            "total_items_in_this_category": 506
        },
        {
            "id": "MLA1472",
            "name": "Departamentos",
            "total_items_in_this_category": 279183
        },
        {
            "id": "MLA1475",
            "name": "Depósitos y Galpones",
            "total_items_in_this_category": 11609
        },
        {
            "id": "MLA50545",
            "name": "Fondo de Comercio",
            "total_items_in_this_category": 2984
        },
        {
            "id": "MLA79242",
            "name": "Locales",
            "total_items_in_this_category": 23445
        },
        {
            "id": "MLA50538",
            "name": "Oficinas",
            "total_items_in_this_category": 16826
        },
        {
            "id": "MLA50544",
            "name": "Parcelas, Nichos y Bóvedas",
            "total_items_in_this_category": 406
        },
        {
            "id": "MLA105179",
            "name": "PH",
            "total_items_in_this_category": 28017
        },
        {
            "id": "MLA50547",
            "name": "Quintas",
            "total_items_in_this_category": 4927
        },
        {
            "id": "MLA1493",
            "name": "Terrenos y Lotes",
            "total_items_in_this_category": 88830
        },
        {
            "id": "MLA50536",
            "name": "Tiempo Compartido",
            "total_items_in_this_category": 299
        },
        {
            "id": "MLA1892",
            "name": "Otros Inmuebles",
            "total_items_in_this_category": 6401
        }
    ],
    "attribute_types": "none",
    "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
            "classified"
        ],
        "catalog_domain": null,
        "coverage_areas": "not_allowed",
        "currencies": [
            "USD",
            "ARS"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
            "not_specified",
            "new",
            "used"
        ],
        "items_reviews_allowed": false,
        "listing_allowed": false,
        "max_description_length": 50000,
        "max_pictures_per_item": 30,
        "max_pictures_per_item_var": 6,
        "max_sub_title_length": 70,
        "max_title_length": 200,
        "maximum_price": null,
        "maximum_price_currency": "ARS",
        "minimum_price": 33,
        "minimum_price_currency": "ARS",
        "mirror_category": null,
        "mirror_master_category": null,
        "mirror_slave_categories": [],
        "price": "required",
        "reservation_allowed": "not_allowed",
        "restrictions": [],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
            "custom",
            "not_specified"
        ],
        "shipping_options": [],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "sub_vertical": "null",
        "subscribable": false,
        "tags": [],
        "vertical": "real_estate",
        "vip_subdomain": "inmueble",
        "buyer_protection_programs": [
            "delivered",
            "undelivered"
        ],
        "status": "enabled"
    },
    "channels_settings": [],
    "meta_categ_id": null,
    "attributable": false,
    "date_created": "2018-04-25T08:12:56.000Z"
}

Obtienes los atributos “path_from_root” y children_categories. Utiliza estos atributos para explorar el árbol de categorías y encontrar la categoría específica para tu publicación. Como puedes ver, las categorías se basan en tipos de propiedad seguidas, en primer lugar, por tipo de operación. Debes seleccionar la categoría hijo.

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA79242

Respuesta:

{
    "id": "MLA1459",
    "name": "Inmuebles",
    "picture": "http://resources.mlstatic.com/category/images/cc0eed64-9cfb-4b78-9258-6266475f6427.png",
    "permalink": "https://www.mercadolibre.com.ar/c/inmuebles",
    "total_items_in_this_category": 652169,
    "path_from_root": [
        {
            "id": "MLA1459",
            "name": "Inmuebles"
        }
    ],
    "children_categories": [
        {
            "id": "MLA374730",
            "name": "Camas Náuticas",
            "total_items_in_this_category": 319
        },
        {
            "id": "MLA1496",
            "name": "Campos",
            "total_items_in_this_category": 5789
        },
        {
            "id": "MLA1466",
            "name": "Casas",
            "total_items_in_this_category": 172797
        },
        {
            "id": "MLA50541",
            "name": "Cocheras",
            "total_items_in_this_category": 9817
        },
        {
            "id": "MLA392265",
            "name": "Consultorios",
            "total_items_in_this_category": 506
        },
        {
            "id": "MLA1472",
            "name": "Departamentos",
            "total_items_in_this_category": 279183
        },
        {
            "id": "MLA1475",
            "name": "Depósitos y Galpones",
            "total_items_in_this_category": 11609
        },
        {
            "id": "MLA50545",
            "name": "Fondo de Comercio",
            "total_items_in_this_category": 2984
        },
        {
            "id": "MLA79242",
            "name": "Locales",
            "total_items_in_this_category": 23445
        },
        {
            "id": "MLA50538",
            "name": "Oficinas",
            "total_items_in_this_category": 16826
        },
        {
            "id": "MLA50544",
            "name": "Parcelas, Nichos y Bóvedas",
            "total_items_in_this_category": 406
        },
        {
            "id": "MLA105179",
            "name": "PH",
            "total_items_in_this_category": 28017
        },
        {
            "id": "MLA50547",
            "name": "Quintas",
            "total_items_in_this_category": 4927
        },
        {
            "id": "MLA1493",
            "name": "Terrenos y Lotes",
            "total_items_in_this_category": 88830
        },
        {
            "id": "MLA50536",
            "name": "Tiempo Compartido",
            "total_items_in_this_category": 299
        },
        {
            "id": "MLA1892",
            "name": "Otros Inmuebles",
            "total_items_in_this_category": 6401
        }
    ],
    "attribute_types": "none",
    "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
            "classified"
        ],
        "catalog_domain": null,
        "coverage_areas": "not_allowed",
        "currencies": [
            "USD",
            "ARS"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
            "not_specified",
            "new",
            "used"
        ],
        "items_reviews_allowed": false,
        "listing_allowed": false,
        "max_description_length": 50000,
        "max_pictures_per_item": 30,
        "max_pictures_per_item_var": 6,
        "max_sub_title_length": 70,
        "max_title_length": 200,
        "maximum_price": null,
        "maximum_price_currency": "ARS",
        "minimum_price": 33,
        "minimum_price_currency": "ARS",
        "mirror_category": null,
        "mirror_master_category": null,
        "mirror_slave_categories": [],
        "price": "required",
        "reservation_allowed": "not_allowed",
        "restrictions": [],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
            "custom",
            "not_specified"
        ],
        "shipping_options": [],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "sub_vertical": "null",
        "subscribable": false,
        "tags": [],
        "vertical": "real_estate",
        "vip_subdomain": "inmueble",
        "buyer_protection_programs": [
            "delivered",
            "undelivered"
        ],
        "status": "enabled"
    },
    "channels_settings": [],
    "meta_categ_id": null,
    "attributable": false,
    "date_created": "2018-04-25T08:12:56.000Z"
}

En este caso, las children_categories son “Venta” y “Alquiler”. Puedes publicar tu inmueble en la que más te convenga.


Categorías JSON

Realizar una llamada a una categoría en particular te permitirá conocer sus atributos. A continuación encontrarás una descripción de algunos de estos atributos. Al realizar una solicitud GET al category_id, encontrarás todos los atributos disponibles y puedes saber si son obligatorios u opcionales para publicar en la categoría.

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA79243

Respuesta:

{
    "id": "MLA79243",
    "name": "Alquiler",
    "picture": null,
    "permalink": null,
    "total_items_in_this_category": 8964,
    "path_from_root": [
        {
            "id": "MLA1459",
            "name": "Inmuebles"
        },
        {
            "id": "MLA79242",
            "name": "Locales"
        },
        {
            "id": "MLA79243",
            "name": "Alquiler"
        }
    ],
    "children_categories": [],
    "attribute_types": "attributes",
    "settings": {
        "adult_content": false,
        "buying_allowed": false,
        "buying_modes": [
            "classified"
        ],
        "catalog_domain": "MLA-RETAIL_SPACE_FOR_RENT",
        "coverage_areas": "not_allowed",
        "currencies": [
            "USD",
            "ARS"
        ],
        "fragile": false,
        "immediate_payment": "optional",
        "item_conditions": [
            "not_specified",
            "new",
            "used"
        ],
        "items_reviews_allowed": false,
        "listing_allowed": true,
        "max_description_length": 50000,
        "max_pictures_per_item": 30,
        "max_pictures_per_item_var": 6,
        "max_sub_title_length": 70,
        "max_title_length": 200,
        "maximum_price": 8000000,
        "maximum_price_currency": "ARS",
        "minimum_price": 33,
        "minimum_price_currency": "ARS",
        "mirror_category": null,
        "mirror_master_category": null,
        "mirror_slave_categories": [],
        "price": "required",
        "reservation_allowed": "not_allowed",
        "restrictions": [],
        "rounded_address": false,
        "seller_contact": "optional",
        "shipping_modes": [
            "custom",
            "not_specified"
        ],
        "shipping_options": [],
        "shipping_profile": "not_allowed",
        "show_contact_information": true,
        "simple_shipping": "not_allowed",
        "stock": "required",
        "sub_vertical": "properties",
        "subscribable": false,
        "tags": [],
        "vertical": "real_estate",
        "vip_subdomain": "inmueble",
        "buyer_protection_programs": [
            "delivered",
            "undelivered"
        ],
        "status": "enabled"
    },
    "channels_settings": [],
    "meta_categ_id": null,
    "attributable": false,
    "date_created": "2018-04-25T08:12:56.000Z"
}

Atributos específicos de las categorías

Para conocer los atributos específicos y valores posibles de las categorías que debes enviar para publicar un publicación, consulta el recurso /attributes.

Ejemplo:

[
  {
    "id": "CONTACT_SCHEDULE",
    "name": "Horario de contacto",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "PROPERTY_TYPE",
    "name": "Inmueble",
    "tags": {
      "fixed": true,
      "product_pk": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "242065",
        "name": "Local"
      }
    ],
    "attribute_group_id": "MAIN",
    "attribute_group_name": "Principales"
  },
  {
    "id": "OPERATION",
    "name": "Operación",
    "tags": {
      "fixed": true,
      "product_pk": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "242073",
        "name": "Alquiler"
      }
    ],
    "attribute_group_id": "MAIN",
    "attribute_group_name": "Principales"
  },
  {
    "id": "TOTAL_AREA",
    "name": "Superficie total",
    "tags": {
      "catalog_required": true,
      "required": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "m²",
        "name": "m²"
      }
    ],
    "default_unit": "m²",
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "COVERED_AREA",
    "name": "Superficie cubierta",
    "tags": {
      "catalog_required": true,
      "required": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "m²",
        "name": "m²"
      }
    ],
    "default_unit": "m²",
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "FULL_BATHROOMS",
    "name": "Baños",
    "tags": {
      "catalog_required": true,
      "required": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "PARKING_LOTS",
    "name": "Cocheras",
    "tags": {
      "catalog_required": true,
      "required": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "WAREHOUSES",
    "name": "Bodegas",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "FLOORS",
    "name": "Pisos",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "PROPERTY_AGE",
    "name": "Antigüedad",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "años",
        "name": "años"
      }
    ],
    "default_unit": "años",
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "IPTU_TAX",
    "name": "Valor del IPTU",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "DFLT",
    "attribute_group_name": "Otros"
  },
  {
    "id": "CONDO_VALUE",
    "name": "Valor del condominio",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "DFLT",
    "attribute_group_name": "Otros"
  },
  {
    "id": "MAINTENANCE_FEE",
    "name": "Expensas",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 255,
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "HAS_INTERNET_ACCESS",
    "name": "Acceso a internet",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "COMOYAMEN",
    "attribute_group_name": "Comodidades y amenities"
  },
  {
    "id": "HAS_TAP_WATER",
    "name": "Agua corriente",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      },
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_AIR_CONDITIONING",
    "name": "Aire acondicionado",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "COMOYAMEN",
    "attribute_group_name": "Comodidades y amenities"
  },
  {
    "id": "HAS_HEATING",
    "name": "Calefacción",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "COMOYAMEN",
    "attribute_group_name": "Comodidades y amenities"
  },
  {
    "id": "HAS_NATURAL_GAS",
    "name": "Gas natural",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_ELECTRIC_GENERATOR",
    "name": "Grupo electrógeno",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_ELECTRIC_LIGHT",
    "name": "Luz eléctrica",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_FIRE_SYSTEM",
    "name": "Sistema contra incendio",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_TELEPHONE_LINE",
    "name": "Línea telefónica",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_SECURITY",
    "name": "Seguridad",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "COMOYAMEN",
    "attribute_group_name": "Comodidades y amenities"
  },
  {
    "id": "HAS_KITCHEN",
    "name": "Cocina",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "AMBIENTES",
    "attribute_group_name": "Ambientes"
  },
  {
    "id": "HAS_FITTING_ROOM",
    "name": "Probador",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "HAS_GUEST_PARKING",
    "name": "Estacionamiento para visitantes",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      },
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      }
    ],
    "attribute_group_id": "COMOYAMEN",
    "attribute_group_name": "Comodidades y amenities"
  },
  {
    "id": "WHEELCHAIR_RAMP",
    "name": "Rampa para silla de ruedas",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      },
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      }
    ],
    "attribute_group_id": "CARACTERISTICAS",
    "attribute_group_name": "Características adicionales"
  },
  {
    "id": "CMG_SITE",
    "name": "Sitio de origen",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "DFLT",
    "attribute_group_name": "Otros"
  },
  {
    "id": "CANONICAL_URL",
    "name": "Url canónica",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "DFLT",
    "attribute_group_name": "Otros"
  },
  {
    "id": "HAS_LIFT",
    "name": "Ascensor",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "ITEM_CONDITION",
    "name": "Condición del ítem",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230581",
        "name": "Usado"
      },
      {
        "id": "2230284",
        "name": "Nuevo"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  }
]

Nombre

Este atributo muestra un nombre corto. Con solo leer el JSON anterior sabes que, por ejemplo, se trata de una categoría de clasificados que no permite incluir opciones de envío, existen 1332 publicaciones publicados en la misma y puedes incluir el precio en ARS o USD.


Atributos obligatorios

Los atributos obligatorios se configuran como “required” en el detalle de la categoría. En el ejemplo anterior, puedes ver que precio y stock son obligatorios; no se permiten las áreas de cobertura y el seller_contact es opcional. Además, atributos específicos de la categoría, como los atributos “Antigüedad” y “Estado”, que tienen el tag “required”: verdadero, se deben enviar con los valores posibles detallados en el JSON.


Descarga de categorías

El árbol de categorías no cambia con mucha frecuencia. Si prefieres, puedes solicitar el volcado de todo el árbol de categorías para el sitio de un país determinado destinado al procesamiento offline. La API devuelve el árbol de categorías en formato JSON dentro de una respuesta codificada con gzip.


Para obtener las categorías de Brasil, utiliza este URL:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/categories/all

Para obtener las categorías de Argentina, utiliza este URL:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories/all

Este URL contiene 2 encabezados que se pueden utilizar para verificar cuándo se generó el último volcado.

  • X-Content-Created : contiene la fecha de la última generación.
  • X-Content-MD5: contiene la suma de comprobación MD5 de la última generación.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories/all

HTTP/1.1 200 OK

  • Server: nginx/1.0.4
  • Date: Tue, 24 Jul 2012 15:14:58 GMT
  • Content-Type: application/json;charset=UTF-8
  • Connection: keep-alive
  • X-MLAPI-Version: 1.9.5
  • Content-Encoding: gzip
  • X-Content-Created: 2012-07-24T14:00:59.716Z
  • X-Content-MD5: 943541196986770119b4af1e66bda2dc

Elige la categoría para tu propiedad

Elegir la categoría correcta para tu inmueble determinará la rapidez con que los compradores la encontrarán y mejorará tus posibilidades de venderla. Por este motivo, te recomendamos utilizar nuestra herramienta de predicción de Categorías antes de publicar un publicación.


Búsqueda por categoría

La operación de búsqueda devuelve publicaciones que pertenecen a una categoría de publicación de MercadoLibre; si bien pueden haber toneladas de publicaciones en ciertas categorías, no te preocupes: puedes paginar los resultados. Lee sobre paginación de los resultados de búsqueda. Para acceder a todos los publicaciones en una categoría determinada, tienes que hacer lo siguiente:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?category=MLA5726

La respuesta de búsqueda tiene gran cantidad de parámetros. Utiliza el método OPCIONES http para obtener una respuesta codificada con JSON que describirá la API, con todos los métodos y conexiones permitidos entre otra parte de la API.


Paginación y dimensionamiento de resultados

Este tutorial te será útil de ahora en adelante porque te ayudará a trabajar con conjuntos específicos de resultados cada vez que realices una llamada a la API. La mayoría de los recursos presentan parámetros url comunes para paginar y dimensionar resultados: limit y offset.

limit

Valores por defecto

Los valores por defecto son offset=0 y limit=50.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?q=ipod nano

En la sección de paginación de la respuesta JSON, puedes ver la cantidad total de publicaciones que coinciden con la búsqueda y el valor de offset con el limit por defecto aplicado.

  "paging": {
    "total": 285,
    "offset": 0,
    "limit": 50,
  }
 ...

Limit

Para reducir el tamaño de página, puedes cambiar el parámetro de limit. Por ejemplo, si estás interesado en recuperar solo los primeros 3 publicaciones:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3

Esta acción recupera un dato JSON con un conjunto de 3 publicaciones, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 284,
    "offset": 0,
    "limit": 3,
  },
  "results": [
    {...},
    {...},
    {...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Offset

Al utilizar el atributo offset, puedes mover el límite inferior del bloque de resultados. Por ejemplo, si te interesa recuperar los 50 publicaciones que siguen la respuesta por defecto:

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50

Respuesta:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 285,
    "offset": 50,
    "limit": 50,
  },
  "results": [...],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Esta respuesta recupera 50 publicaciones a partir de los primeros cincuenta.


Definir un rango de resultados

Es posible combinar ambos parámetros. Puedes recuperar publicaciones desde el tercero al sexto en el resultado de búsqueda original:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=3&limit=3

Esta acción recupera un dato JSON con un conjunto de 5 publicaciones, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 285,
    "offset": 3,
    "limit": 3,
  },
  "results": [
    {...},
    {...},
    {...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}
https://api.mercadolibre.com/sites/MLA/search/

Siguiente: Localiza inmuebles.