Selección de tipo de operación y propiedad

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. https://api.mercadolibre.com/sites/MLB/categories
Antes de publicar un 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.

Contenidos:

Categorías por Site

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

https://api.mercadolibre.com/sites/MLA/categories
{
	"id": "MLA5725",
	"name": "Accesorios para Vehículos"
  },
  {
	"id": "MLA1071",
	"name": "Animales y Mascotas"
  },
  {
	"id": "MLA1367",
	"name": "Antigüedades"
  },
  {
	"id": "MLA1368",
	"name": "Arte y Artesanías"
  },
  {
	"id": "MLA1743",
	"name": "Autos, Motos y Otros"
  },
  {
	"id": "MLA1384",
	"name": "Bebés"
  },
  {
	"id": "MLA1051",
	"name": "Celulares y Teléfonos"
  },
  {
	"id": "MLA1798",
	"name": "Coleccionables y Hobbies"
  },
  {
	"id": "MLA1648",
	"name": "Computación"
  },
  {
	"id": "MLA1144",
	"name": "Consolas y Videojuegos"
  },
  {
	"id": "MLA1039",
	"name": "Cámaras y Accesorios"
  },
  {
	"id": "MLA1403",
	"name": "Delicatessen y Vinos"
  },
  {
	"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": "MLA1574",
	"name": "Hogar, Muebles y Jardín"
  },
  {
	"id": "MLA1499",
	"name": "Industrias y Oficinas"
  },
  {
	"id": "MLA1459",
	"name": "Inmuebles"
  }

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”:

https://api.mercadolibre.com/categories/MLA1459
{
  "id": "MLA1459",
  "name": "Inmuebles",
  "picture": "http://resources.mlstatic.com/category/images/cc0eed64-9cfb-4b78-9258-6266475f6427.png",
  "permalink": "http://www.mercadolibre.com.ar/inmuebles/",
  "total_items_in_this_category": 109788,
  "path_from_root": [
	{
  	"id": "MLA1459",
  	"name": "Inmuebles"
	}
  ],
  "children_categories": [
	{
  	"id": "MLA374730",
  	"name": "Camas Náuticas",
  	"total_items_in_this_category": 56
	},
	{
  	"id": "MLA1496",
  	"name": "Campos",
  	"total_items_in_this_category": 747
	},
	{
      "id": "MLA1466",
  	"name": "Casas",
  	"total_items_in_this_category": 29579
	},
	{
  	"id": "MLA50541",
  	"name": "Cocheras",
  	"total_items_in_this_category": 1659
	},
	{
  	"id": "MLA1472",
  	"name": "Departamentos",
  	"total_items_in_this_category": 43732
	},
	{
  	"id": "MLA1475",
  	"name": "Depósitos y Galpones",
  	"total_items_in_this_category": 1474
	},
	{
  	"id": "MLA50545",
  	"name": "Fondo de Comercio",
  	"total_items_in_this_category": 1925
	},
	{
  	"id": "MLA79242",
  	"name": "Locales",
  	"total_items_in_this_category": 2533
	},
	{
  	"id": "MLA50538",
  	"name": "Oficinas y Consultorios",
  	"total_items_in_this_category": 2711
	},
	{
  	"id": "MLA1892",
  	"name": "Otros Inmuebles",
  	"total_items_in_this_category": 2236
	},
	{
  	"id": "MLA105179",
  	"name": "PH",
  	"total_items_in_this_category": 3066
	},
	{
  	"id": "MLA50544",
  	"name": "Parcelas, Nichos y Bóvedas",
  	"total_items_in_this_category": 230
	},
	{
  	"id": "MLA50547",
  	"name": "Quintas",
  	"total_items_in_this_category": 1828
	},
	{
  	"id": "MLA1493",
  	"name": "Terrenos y Lotes",
  	"total_items_in_this_category": 17463
	},
	{
  	"id": "MLA50536",
  	"name": "Tiempo Compartido",
  	"total_items_in_this_category": 566
	}
  ],
  "attribute_types": "attributes",
  "settings": {
	"adult_content": false,
	"buying_allowed": false,
	"buying_modes": [
  	"classified"
    ],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"new",
  	"not_specified",
  	"used"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"custom",
  	"not_specified"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": false,
	"maximum_price": null,
	"minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": true
}

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:

https://api.mercadolibre.com/categories/MLA79242

Respuesta:

{
  "id": "MLA79242",
  "name": "Locales",
  "picture": "http://resources.mlstatic.com/category/images/f1f2bbe1-b5d4-45b1-9b9c-ac142b6bc64f.png",
  "permalink": null,
  "total_items_in_this_category": 2533,
  "path_from_root": [
	{
  	"id": "MLA1459",
  	"name": "Inmuebles"
	},
	{
  	"id": "MLA79242",
  	"name": "Locales"
	}
  ],
  "children_categories": [
	{
  	"id": "MLA79243",
  	"name": "Alquiler",
  	"total_items_in_this_category": 1332
	},
	{
  	"id": "MLA79244",
  	"name": "Venta",
  	"total_items_in_this_category": 1197
	}
  ],
  "attribute_types": "attributes",
  "settings": {
	"adult_content": false,
	"buying_allowed": false,
	"buying_modes": [
  	"classified"
    ],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"not_specified",
  	"used",
  	"new"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"custom",
  	"not_specified"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": false,
	"maximum_price": null,
	"minimum_price": null
  },
  "meta_categ_id": 23362,
  "attributable": false
}

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:

https://api.mercadolibre.com/categories/MLA79243

Respuesta:

{
  "id": "MLA79243",
  "name": "Alquiler",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 1332,
  "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"
	],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"new",
  	"not_specified",
  	"used"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"not_specified",
  	"custom"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": true,
	"maximum_price": 250000,
	"minimum_price": 100
  },
  "meta_categ_id": 12620,
  "attributable": false
}

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 atributos:

Ejemplo:

https://api.mercadolibre.com/categories/MLA79243/attributes
{
	"id": "MLA1459-INMUEBLE",
	"name": "Inmueble",
	"value_type": "list",
	"tags": {
  	"fixed": true,
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA1459-INMUEBLE-LOCALES",
    	"name": "Locales"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA1459-OPERACION",
	"name": "Operación",
    "value_type": "list",
	"tags": {
  	"fixed": true,
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA1459-OPERACION-ALQUILER",
    	"name": "Alquiler"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-ANTIG",
	"name": "Antigüedad",
	"value_type": "list",
	"tags": {
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA79242-ANTIG-A_ESTRENAR",
    	"name": "A estrenar"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_5_ANOS",
    	"name": "Max 5 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_10_ANOS",
    	"name": "Max 10 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_20_ANOS",
    	"name": "Max 20 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_30_ANOS",
    	"name": "Max 30 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_40_ANOS",
    	"name": "Max 40 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAS_DE_40_ANOS",
        "name": "Más de 40 años"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-BATHQTY",
	"name": "Baños",
	"value_type": "list",
	"tags": {
  	"required": true
	},
    "values": [
  	{
    	"id": "MLA79242-BATHQTY-1",
    	"name": "1"
  	},
  	{
    	"id": "MLA79242-BATHQTY-2",
    	"name": "2"
  	},
  	{
    	"id": "MLA79242-BATHQTY-3",
    	"name": "3"
  	},
  	{
    	"id": "MLA79242-BATHQTY-4",
    	"name": "4"
  	},
  	{
    	"id": "MLA79242-BATHQTY-MAS_DE_4",
    	"name": "Más de 4"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-ESTADO",
	"name": "Estado",
	"value_type": "list",
	"tags": {
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA79242-ESTADO-A_REFACCIONAR",
    	"name": "A refaccionar"
  	},
  	{
    	"id": "MLA79242-ESTADO-BUENO",
        "name": "Bueno"
  	},
  	{
    	"id": "MLA79242-ESTADO-EXCELENTE",
    	"name": "Excelente"
  	},
  	{
    	"id": "MLA79242-ESTADO-MUY_BUENO",
    	"name": "Muy bueno"
  	},
  	{
    	"id": "MLA79242-ESTADO-REGULAR",
    	"name": "Regular"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-SUPCONSCL",
	"name": "Superficie construida (m²)",
	"value_type": "number",
	"value_max_length": 60,
	"tags": {
  	"required": true
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-SUPTOTMX",
	"name": "Superficie total (m²)",
	"value_type": "number",
	"value_max_length": 60,
	"tags": {
  	"required": true
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA1459-HORPREF",
	"name": "Horario de contacto",
	"value_type": "string",
	"value_max_length": 60,
	"tags": {
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-PISOSQTY",
	"name": "Plantas",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-PISOSQTY-1",
    	"name": "1"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-2",
    	"name": "2"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-3",
    	"name": "3"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-MAS_DE_3",
    	"name": "Más de 3"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-LOCALI",
	"name": "Localización",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LOCALI-A_LA_CALLE",
    	"name": "A la calle"
  	},
  	{
    	"id": "MLA79242-LOCALI-CENTRO_COMERCIAL",
    	"name": "Centro comercial"
  	},
  	{
    	"id": "MLA79242-LOCALI-GALERIA",
    	"name": "Galería"
  	},
  	{
    	"id": "MLA79242-LOCALI-SHOPPING",
    	"name": "Shopping"
  	},
  	{
    	"id": "MLA79242-LOCALI-OTRO_LUGAR",
    	"name": "Otro lugar"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-AGUACORR",
	"name": "Agua Corriente",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-AGUACORR-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-AGUACORR-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-AIRACON",
	"name": "Aire acondicionado",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-AIRACON-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-AIRACON-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ALARSEG",
	"name": "Alarma de seguridad",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ALARSEG-N",
    	"name": "No"
  	},
  	{
        "id": "MLA79242-ALARSEG-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ELEVATOR",
	"name": "Ascensor",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ELEVATOR-SI",
    	"name": "Sí"
  	},
  	{
    	"id": "MLA79242-ELEVATOR-NO",
    	"name": "No"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-CALEF",
	"name": "Calefacción",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-CALEF-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-CALEF-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "GARAGE",
	"name": "Cocheras",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "GARAGE-6a020b",
    	"name": "No tiene"
  	},
  	{
    	"id": "GARAGE-c4ca42",
    	"name": "1"
  	},
  	{
    	"id": "GARAGE-c81e72",
    	"name": "2"
  	},
  	{
    	"id": "GARAGE-eccbc8",
    	"name": "3"
  	},
  	{
    	"id": "GARAGE-a87ff6",
    	"name": "4"
  	},
  	{
    	"id": "GARAGE-caf5ad",
    	"name": "Más de 4"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-COCINA",
	"name": "Cocina",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-COCINA-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-COCINA-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-INTERNET",
	"name": "Conexión a Internet",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-INTERNET-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-INTERNET-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-DEPOSITO",
	"name": "Depósito",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-DEPOSITO-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-DEPOSITO-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ENTREPISO",
	"name": "Entrepiso",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ENTREPISO-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-ENTREPISO-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-EXPENCEM",
	"name": "Expensas ($)",
	"value_type": "string",
	"value_max_length": 60,
	"tags": {
	},
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-GRUPOELEC",
	"name": "Grupo eletrógeno",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-GRUPOELEC-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-GRUPOELEC-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-LUMINOS",
	"name": "Luminosidad",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LUMINOS-BUENA",
    	"name": "Buena"
  	},
  	{
    	"id": "MLA79242-LUMINOS-MUY_BUENA",
    	"name": "Muy buena"
  	},
  	{
    	"id": "MLA79242-LUMINOS-REGULAR",
	    "name": "Regular"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-LINTELEF",
	"name": "Línea telefónica",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LINTELEF-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-LINTELEF-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-SISTINCEN",
	"name": "Sistema contra incendio",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-SISTINCEN-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-SISTINCEN-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-TVCABLE",
	"name": "TV por cable",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-TVCABLE-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-TVCABLE-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-VESTU",
	"name": "Vestuario",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-VESTU-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-VESTU-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  }

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  	https://api.mercadolibre.com/sites/MLB/categories/all

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

~$ curl  	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 [contenido X creado]: contiene la fecha de la última generación.
● X-Content-MD5: contiene la suma de comprobación MD5 de la última generación.

~$ curl -I  https://api.mercadolibre.com/sites/MLB/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 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. https://api.mercadolibre.com/sites/MLA/search/.

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 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 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:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50
{
  "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 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 artículos.

Por favor califica del 1 al 5