Categorias

API de Categorias: descubra o tipo de imóvel e operação necessários para publicar

Para identificar a categoria correta e os valores permitidos para esses atributos, siga estes passos:

1. Identifique a categoria de imóveis por país

Para identificar a categoria à qual sua publicação pertence, você deve executar os comandos descritos especificamente para o seu país:

• Argentina (MLA)
• Chile (MLC)
• Uruguai (MLU)
• Colômbia (MCO)
• México (MLM)
• Brasil (MLB)

Para obter a lista de categorias disponíveis para o seu país — por exemplo, para a Argentina (MLA) —, você pode executar a seguinte chamada:

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

Exemplo de resposta:

[
    {
        "id": "MLA1747",
        "name": "Acessórios para Veículos"
    },
    ...

    {
        "id": "MLA1459",
        "name": "Imóveis"
    },
    ...
]

2. Identifique o tipo de imóvel a ser publicado

Para identificar o Tipo de Imóvel (PROPERTY_TYPE), utilize a API de Categorias, partindo da categoria de imóveis que você obteve anteriormente.

Exemplo: Se a categoria de imóveis para a Argentina é "MLA1459", execute a seguinte chamada:

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

Na resposta JSON, procure a propriedade children_categories. Essa propriedade contém uma lista de subcategorias que representam os diferentes tipos de imóveis disponíveis para publicação (ex: Casas, Apartamentos, Escritórios, etc.).

Depois de selecionar o Tipo de Imóvel desejado, guarde o ID da categoria correspondente. Você precisará dele nos próximos passos.

Exemplo de resposta:

{
  "id": "MLA1459",
  "name": "Inmuebles",
  "picture": "https://http2.mlstatic.com/storage/categories-api/images/cc0eed64-9cfb-4b78-9258-6266475f6427.png",
  "permalink": "https://www.mercadolibre.com.ar/c/inmuebles",
  "total_items_in_this_category": 599111,
  "path_from_root": [
    { "id": "MLA1459", "name": "Inmuebles" }
  ],
  "children_categories": [
    { "id": "MLA374730", "name": "Camas Náuticas", "total_items_in_this_category": 224 },
    { "id": "MLA1496", "name": "Campos", "total_items_in_this_category": 5133 },
    { "id": "MLA1466", "name": "Casas", "total_items_in_this_category": 173125 },
    { "id": "MLA50541", "name": "Cocheras", "total_items_in_this_category": 8850 },
    { "id": "MLA392265", "name": "Consultorios", "total_items_in_this_category": 383 },
    { "id": "MLA1472", "name": "Departamentos", "total_items_in_this_category": 221319 },
    { "id": "MLA1475", "name": "Depósitos y Galpones", "total_items_in_this_category": 10606 },
    { "id": "MLA50545", "name": "Fondo de Comercio", "total_items_in_this_category": 2251 },
    { "id": "MLA79242", "name": "Locales", "total_items_in_this_category": 18570 },
    { "id": "MLA50538", "name": "Oficinas", "total_items_in_this_category": 13851 },
    { "id": "MLA1892", "name": "Otros Inmuebles", "total_items_in_this_category": 5336 },
    { "id": "MLA105179", "name": "PH", "total_items_in_this_category": 25918 },
    { "id": "MLA50544", "name": "Parcelas, Nichos y Bóvedas", "total_items_in_this_category": 250 },
    { "id": "MLA50547", "name": "Quintas", "total_items_in_this_category": 5525 },
    { "id": "MLA1493", "name": "Terrenos y Lotes", "total_items_in_this_category": 106149 },
    { "id": "MLA50536", "name": "Tiempo Compartido", "total_items_in_this_category": 253 }
  ],
  "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,
    "max_variations_allowed": 100,
    "maximum_price": null,
    "maximum_price_currency": "ARS",
    "minimum_price": 65,
    "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_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": [
    { "channel": "proximity", "settings": { "status": "disabled" } },
    { "channel": "mp-merchants", "settings": { "buying_modes": ["buy_it_now"], "immediate_payment": "required", "minimum_price": 0.01, "status": "enabled" } },
    { "channel": "mp-link", "settings": { "buying_modes": ["buy_it_now"], "immediate_payment": "required", "minimum_price": 0.01, "status": "enabled" } }
  ],
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

3. Identifique o tipo de operação a ser publicada

Para identificar o Tipo de Operação (OPERATION), utilize novamente a API de Categorias /categories/${ID}. Substitua o ID pelo da categoria do Tipo de Imóvel que você obteve no passo anterior na requisição.

Exemplo: Se você selecionou a categoria "Casas" na Argentina (ex: "MLA1466"), utilize a seguinte chamada:

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

Na resposta JSON, procure novamente a propriedade children_categories. Dentro dessa propriedade, você encontrará os diferentes tipos de operações disponíveis (ex: Aluguel, Venda, etc.).

Guarde o ID da categoria correspondente ao tipo de operação desejado para o próximo passo.

Exemplo de resposta:

{
  "id": "MLA1466",
  "name": "Casas",
  "picture": "https://http2.mlstatic.com/storage/categories-api/images/25ef57e2-fff4-446b-8c1e-b6bb8a76efc3.png",
  "permalink": null,
  "total_items_in_this_category": 173881,
  "path_from_root": [
    { "id": "MLA1459", "name": "Imóveis" },
    { "id": "MLA1466", "name": "Casas" }
  ],
  "children_categories": [
    { "id": "MLA1467", "name": "Aluguel", "total_items_in_this_category": 5299 },
    { "id": "MLA50278", "name": "Aluguel Temporário", "total_items_in_this_category": 15676 },
    { "id": "MLA1468", "name": "Venda", "total_items_in_this_category": 152906 }
  ],
  "attribute_types": "none",
  "settings": { ... },
  "channels_settings": [ ... ],
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

Os atributos dessa resposta são semelhantes aos da resposta anterior.

4. Identifique se o imóvel é novo ou usado (subtipo de operação)

Para identificar o Subtipo de Operação (OPERATION_SUBTYPE), utilize novamente a API de Categorias. Substitua o ID da categoria do Tipo de Operação que você obteve no passo anterior na requisição.

Exemplo: Se você selecionou a categoria "Venda" na Argentina (ex: "MLA1468"), execute a seguinte chamada:

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

Na resposta JSON, procure novamente a propriedade children_categories. Dentro dessa propriedade, você encontrará os diferentes subtipos de operação disponíveis para publicação (ex: Empreendimentos, Propriedades Usadas, etc.).

Guarde o ID da categoria correspondente ao Subtipo de Operação desejado. Este será o ID final que você utilizará para publicar o imóvel, pois representa a categoria mais específica.

Exemplo de resposta:

{
  "id": "MLA1468",
  "name": "Venda",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 152906,
  "path_from_root": [
    { "id": "MLA1459", "name": "Imóveis" },
    { "id": "MLA1466", "name": "Casas" },
    { "id": "MLA1468", "name": "Venda" }
  ],
  "children_categories": [
    { "id": "MLA401805", "name": "Empreendimentos", "total_items_in_this_category": 124 },
    { "id": "MLA401685", "name": "Propriedades Individuais", "total_items_in_this_category": 152081 }
  ],
  "attribute_types": "none",
  "settings": { ... },
  "channels_settings": [ ... ],
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

Os atributos dessa resposta são semelhantes aos das respostas anteriores.

5. Seleção de categoria

Neste exemplo, publicaremos uma propriedade usada, selecionada a partir da resposta anterior. Portanto, a categoria final que utilizaremos para publicar o imóvel será "MLC157520", assumindo que este ID corresponde a "Propriedades Usadas" dentro da categoria "Venda" de "Casas" no Chile.

Este identificador deve ser incluído no campo category_id do corpo da requisição que será enviada para publicar o imóvel. Pronto! Agora você já identificou a categoria onde o seu imóvel será publicado.

Próximos Passos

Para realizar a publicação, também será necessário identificar outros atributos obrigatórios e opcionais. Portanto, acesse a seção de atributos.

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações