Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 04/11/2024
Categorías y Atributos
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/categoriesRespuesta:
[
{
"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/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"
}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/MLA79242Respuesta:
{
"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/MLA79243Respuesta:
{
"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/allPara obtener las categorías de Argentina, utiliza este URL:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/categories/allEste 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/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
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=MLA5726La 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.
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 nanoEn 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=3Esta 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=50Respuesta:
{
"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=3Esta 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.