Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 02/04/2025
Categories and Attributes
Categories by Site
The Sites resource can give you the category structure for a particular country, in this case Argentina.
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categoriesResponse:
[
{
"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"
}
]For second level categories, or information related to specific categories, you have to use the Categories resource sending the category Id as a URL parameter.
Let’s see what we find under “Inmuebles” category.
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1459Respuesta:
{
"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"
}You get the “path_from_root” and children_categories attributes. Use these attributes to browse through the category tree and find the specific category for your item. As you can see, categories are based on property types first followed by operation type. You need to choose the children category.
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA79242Response:
{
"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"
}On this case the children_categories are “Venta” and “Alquiler”. You can list your real estate property under the one that suits you better.
Categories JSON
Making a call to a particular category will let you know the attributes that belong to it. Following you’ll find a description of some of these attributes. When you make a GET to the category_id, you’ll find all available attributes and you can know if they’re required to list under the category or if they’re optional.
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA79243Response:
{
"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"
}Specific category attributes
To know the specific category attributes and possible values you need to send to list an item check the /attributes resource.
Example:
[
{
"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"
}
]Mandatory attributes
Mandatory attributes are set as “required” under the category detail. On the example above you can see that price and stock are required, coverage areas are not allowed and seller_contact is optional. Also specific category attributes like attributes like “Antigüedad” and “Estado” that has the tag “required”: true, need to be sent with the possible values detailed on the Json.
Category Dump
The category tree does not change very often. If you prefer, you can request a dump of the whole category tree for a given country site for offline processing. This API returns the category tree in JSON format within a gzip-encoded response.
To get the categories for Brazil, use this URL:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/categories/allTo get the categories for Argentina, use this URL:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories/allThis URL contains 2 headers that can be used to check when the last dump was generated.
- X-Content-Created: contains the date of the last generation.
- X-Content-MD5: contains the MD5 checksum of the last generation.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories/allHTTP/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
Choose category for your property
Choosing the right category for your real estate property will determine how quickly buyers will find your item and will improve your chances of selling it. For this reason, we highly recommend to use our Category predictor tool before listing an item.
Next topic: Locate your properties.