• API Docs
  • Guia para imóveis
  • Categorias e Atributos

Categorias e Atributos


As categorias são um conjunto hierárquico de grupos nos quais são enumerados os produtos de natureza similar, denominados "árvore de categorias". As categorias ajudam os usuários a buscar facilmente o tipo de produto desejado. Cada site tem seu próprio conjunto de categorias, isto é, a Argentina terá um conjunto único de categorias diferentes das que você vai encontrar no Brasil, porque cada país tem suas características particulares classificadas no mercado.
Antes de publicar um produto, você deve explorar a estrutura de categorias e escolher em qual delas quer publicar. Como ajuda, você pode baixar a hierarquia completa das categorias com ID e nome simples, de nossa API. Para fazer a publicação de um imóvel, você deverá selecionar a category_id dependendo do tipo de operação e imóvel.


Conteúdo

→Categorias por site
→Categorias JSON
→Atributos específicos das categorias
→Nome
→Atributos obrigatórios
→Dump de categorias
→Seleção de categorias
→Busca por categoria
→Valores padrão
→Limite
→Deslocamento
→Definição de uma faixa de resultados


Categorias por site

O recurso Sites pode oferecer a estrutura de categorias de um país em particular.

Exemplo:

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

Resposta:

[
    {
        "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 categorias do segundo nível, ou informações relacionadas com categorias específicas, você deverá utilizar o recuso Categories e enviar o ID da categoria como parâmetro URL.

Veja o que podemos encontrar na categoria "Inmuebles" (Imóveis):

Exemplo:

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

Resposta:

{
    "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"
}

Você obtém os atributos “path_from_root” e children_categories. Utilize esses atributos na exploração da árvore de categorias para encontrar a categoria específica de seu produto. Como você pode observar, as categorias são baseadas nos tipos de imóveis e elas vêm seguidas, em primeiro lugar, do tipo de operação.


Exemplo:

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

Resposta:

{
    "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"
}

Nesse caso, as children_categories são “Venta” (Vendas) e “Alquiler" (Aluguel). Você pode publicar seu imóvel na que achar mais conveniente.


Categorias JSON

Realizar uma chamada para uma categoria em particular permitirá conhecer seus atributos. A seguir, encontre uma descrição de alguns desses atributos. Ao realizar uma solicitação GET para a categoria category_id, você encontrará todos os atributos disponibilizados e poderá saber se eles são obrigatórios ou opcionais para publicar na categoria.

Exemplo:

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

Resposta:

{
    "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 das categorias

Para conhecer os atributos específicos e valores possíveis das categorias que você deve encaminhar para publicar um produto, consulte o recurso /attributes

Exemplo:

[
  {
    "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"
  }
]

Nome

Este atributo mostra uma etiqueta simples. Somente lendo o JSON anterior você sabe que, por exemplo, trata-se de uma categoria de classificados que não comporta a inclusão de opções de envio. Existem 1.332 produtos publicados. e você pode incluir o preço em ARS ou USD.


Atributos obrigatórios

Os atributos obrigatórios são configurados como “required” nos detalhes da categoria. No exemplo anterior, você pode observar que preço e estoque são obrigatórios; não são autorizadas áreas de cobertura e o seller_contact é opcional. Além disso, atributos específicos da categoria, como "Antiguidade" e "Estado", que têm a tag "required": verdadeiro, devem ser enviados com os valores possíveis detalhados no JSON.


Dump de categorias

A árvore de categorias não é alterada frequentemente. Se você preferir, pode solicitar o dump de toda a árvore de categorias para o site de um determinado país para processamento off-line. A API retorna a árvore de categorias no formato JSON em uma resposta codificada em gzip.

Para obter as categorias do Brasil, utilize a URL abaixo:

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

Para obter as categorias da Argentina, utilize a URL abaixo:

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

Essa URL contém dois cabeçalhos que podem ser utilizados para verificar quando foi gerado o último dump.

  • X-Content-Created : contêm a data da última geração.
  • X-Content-MD5: contém a soma de verificação MD5 da última geração.
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

Seleção de categorias

A escolha da categoria certa para seu imóvel determinará a rapidez com que ele será encontrado pelos compradores, melhorando suas chances de venda. Por isso, recomendamos utilizar a nossa ferramenta de predição de Categorias antes de publicar um produto.


Busca por categoria

Na operação de busca aparecem produtos pertencentes a uma categoria de produto do Mercado Livre. Apesar de existirem toneladas de produtos em algumas categorias, não se preocupe: você poderá paginar os resultados. Leia sobre paginação dos resultados de busca. Para obter todos os produtos de uma determinada categoria, você precisa fazer o seguinte:

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

A resposta da busca tem uma enorme quantidade de parâmetros. Utilize o método http OPÇÕES para obter uma resposta codificada em JSON que descreverá a API com todos os métodos e conexões permitidos entre ele e a outra parte da API. https://api.mercadolibre.com/sites/MLA/search/.


Paginação e dimensionamento dos resultados

Daqui em diante, este tutorial será útil para trabalhar com conjuntos específicos de resultados toda vez que você fizer uma chamada à API. A maior parte dos recursos apresentam parâmetros URL normais para paginar e dimensionar resultados: limit y offset.

limit

Valores padrão

Os valores padrão são: deslocamento=0 e limite=50.

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

Na seção de paginação da resposta JSON, você pode visualizar a quantidade total de produtos que correspondem à busca e o valor de deslocamento com o limite padrão aplicado.

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

Limite

Para reduzir o tamanho da página, você pode alterar o parâmetro do limite. Por exemplo, caso esteja interessado em recuperar somente os três primeiros produtos:

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

Essa ação recupera dados do JSON com um conjunto de três produtos, conforme mostrado a seguir:

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

Deslocamento

Ao usar o atributo deslocamento, você pode mover o limite inferior do bloco de resultados. Por exemplo, se estiver interessado em recuperar os 50 produtos que seguem à resposta padrão:

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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": [...],
}

A resposta acima recupera 50 produtos a partir dos primeiros cinquenta.


Definição de uma faixa de resultados

Ambos os parâmetros podem ser combinados. Você pode recuperar produtos do terceiro ao sexto no resultado da busca original:

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

Essa ação recupera um dado do JSON com um conjunto de cinco produtos, conforme mostrado a seguir:

{
  "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/

Próximo: Localização de imóveis.
banner footer

Inscreva-se em nosso Newsletter

ou registre-se para receber as últimas notícias sobre nossa API