Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 02/04/2025

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

Importante:
A partir de 04/11/2024, en MLM (para los dominios de venta de inmuebles), será obligatorio el atributo IS_PROPERTY_IN_AUCTION. El atributo IS_PROPERTY_IN_AUCTION se refiere a propiedades que se encuentran en la condición de Remate Bancario, facilitando para los compradores la condición del inmueble en el momento de la búsqueda. Buscamos ofrecer con esta implementación una mejor visibilidad, ya que los inmuebles en esta condición se venden a un precio mejor en comparación con el mercado.

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.



Siguiente: Localiza inmuebles.