Atributos

Attributes API: descubra os atributos essenciais que você precisa para publicar

Siga os passos abaixo para identificar os atributos obrigatórios.

Uso do endpoint /attributes

Utilize o endpoint /attributes da API do Mercado Livre, especificando a categoria final que você selecionou.

Exemplo: Se a categoria final for MLA401685 (Casas à venda como Propriedades Individuais na Argentina), execute a seguinte chamada:

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

A resposta JSON que você receberá é extensa. No início, encontrará informações resumidas sobre a categoria consultada. Em seguida, virá a lista de atributos necessários para as suas publicações.

Por exemplo, os seguintes campos:

{
  "id": "COVERED_AREA",
  "name": "Área útil",
  "tags": {
    "required": true,
    "catalog_listing_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": "BEDROOMS",
  "name": "Quartos",
  "tags": {
    "required": true,
    "catalog_listing_required": true
  },
  "hierarchy": "ITEM",
  "relevance": 1,
  "value_type": "number",
  "value_max_length": 18,
  "attribute_group_id": "FIND",
  "attribute_group_name": "Ficha técnica"
}

Cada atributo possui a seguinte estrutura:

Atributos Importantes a Considerar

Ao realizar a consulta por meio da API, encontraremos os seguintes atributos essenciais no momento de criar suas publicações de imóveis:

1. Preço:
   Obrigatoriedade: O preço é um atributo obrigatório e deve estar incluído na publicação.
   Formato: Deve ser um valor numérico que represente o preço de venda ou aluguel da propriedade.


2. Moeda:
   Obrigatoriedade: A moeda é um atributo obrigatório.
   Identificação: Você deve definir a moeda utilizando um ID preestabelecido.
   Obtenção de IDs: Os IDs das moedas disponíveis são obtidos chamando a categoria onde deseja publicar seu item. Consulte nossa guia Categorias para mais informações.


3. Despesas Comuns (Condomínio):
   Atributo: Utilize o atributo MAINTENANCE_FEE.
   Obrigatoriedade: Este atributo é obrigatório.
   Valor: Inclua o valor monetário da despesa comum mensal na moeda correspondente do país (cada moeda possui um ID preestabelecido).


4. Permite Animais de Estimação:
   Atributo: Utilize o atributo IS_SUITABLE_FOR_PETS.
   Obrigatoriedade: Este atributo é obrigatório e deve ser enviado.
   Valores: Os valores definidos são "Sim" ou "Não" (junto com o ID preestabelecido correspondente) para indicar se o imóvel aceita animais de estimação.


5. Estacionamento:
   Atributo: Utilize o atributo PARKING_LOTS.
   Obrigatoriedade: Este é um valor numérico obrigatório.
   Valor: Indica o número de vagas de estacionamento disponíveis na propriedade.


6. Depósito (Armazenamento):
   Atributo: Utilize o atributo WAREHOUSES.
   Obrigatoriedade: Este é um valor numérico obrigatório.
   Valor: Indica o número de espaços de depósito ou armazenamento disponíveis na propriedade.


7. Banheiros Completos:
   Atributo: Utilize o atributo FULL_BATHROOMS.
   Obrigatoriedade: Este é um valor numérico obrigatório.
   Valor: Indica a quantidade de banheiros completos disponíveis na propriedade.


8. Mobiliado:
   Atributo: Utilize o atributo FURNISHED.
   Obrigatoriedade: Este atributo é obrigatório.
   Valores: Indica se a propriedade está mobiliada com "Sim" ou "Não" (junto com o ID correspondente).


9. Tipo de Publicação:
   Atributo: Utilize o atributo Listing Type.
   Descrição: Refere-se ao plano contratado para a publicação.
   Obrigatoriedade: É um atributo obrigatório que aceita apenas valores predefinidos.
   Obtenção de Listing Types: Você deve realizar uma chamada por meio dos recursos de sites e listing_types para conhecer os tipos de publicação suportados.
   Guia: Siga nossa guia para saber qual tipo de publicação é mais adequada para o seu imóvel.


10. Quantidade Disponível:
    Atributo: Utilize o atributo available_quantity.
    Valor: Sempre deve ser enviado como "1".
    Representação: Representa a quantidade de itens da publicação. No Mercado Livre, as publicações de classificados não trabalham com estoque; cada uma representa um registro único de imóvel, veículo ou serviço.


11. Condição:
    Atributo: Utilize o atributo Condition.
    Descrição: Representa a condição do imóvel — se é novo ou usado.
    Valores Possíveis: Pode ser "new", "used" ou "not_specified", dependendo da condição da publicação.

Para mais informações, você pode consultar a seção de Atributos específicos das categorias no guia de categorias e atributos.

Atributos adicionais

Além dos atributos consultados por meio da API, existem outros aspectos importantes que você deve considerar ao criar suas publicações de imóveis.

1. Título da publicação

• Formato: O título deve seguir o seguinte formato: Tipo de Operação (Aluguel/Venda/Aluguel Temporário) + Tipo de Imóvel + Cômodos + Bairro.
• Importância: As palavras-chave no título são essenciais, pois correspondem às buscas dos usuários. Um título preciso e completo melhora a visibilidade da sua publicação.
• Recomendação: Evite adjetivos e abreviações. Utilize termos claros e específicos.

Exemplo:

title: "Venda Apartamento 4 cômodos Recoleta."

2. Descrição do imóvel

• Formato: A descrição deve ser em texto simples, sem formatação HTML nem etiquetas.
• Restrições: Não inclua informações de contato (telefone, endereço, site). Incluir esses dados resultará em moderação ou penalização da publicação.
• Processo de criação: Primeiro, crie a publicação sem descrição. Depois, adicione a descrição enviando um POST ao recurso /items/$ITEM_ID/description.

Para saber mais, consulte descrição de produtos .

Exemplo:

curl -L -X POST 'https://api.mercadolibre.com/items/$ITEM_ID/description' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "plain_text":"Descrição em Texto Simples  \n"
}'

3. Localização do imóvel

• Obrigatoriedade: A localização é obrigatória para anúncios classificados.
• Níveis de localização: O Mercado Livre utiliza quatro níveis: país (country), estado, cidade (city) e bairro (neighborhood).
• Requisito mínimo: É necessário informar pelo menos a cidade (city) ou o bairro (neighborhood).

Para obter mais informações, consulte a seção Localizar imóveis.

4. Contatos do vendedor

• Opcionalidade: As informações de contato do vendedor são opcionais. Caso não sejam fornecidas, serão utilizadas as informações da conta do vendedor.
• Notificações por e-mail: As perguntas dos compradores são enviadas para o e-mail do vendedor (campo seller_contact.email). Se não for especificado, será usado o e-mail da conta do vendedor.
• Gestão de perguntas por API: Utilize o guia Gerencie perguntas e respostas.
• Restrição "seller_contact": "not_allowed": Se este campo estiver configurado como "not_allowed", a categoria não permitirá carregar informações de contato.
• Contatos via WhatsApp: Os campos country_code2, area_code2 e phone2 permitem receber contatos por WhatsApp.

Exemplo:

seller_contact: {
  contact: "Nome Contato Teste",
  area_code: "11",
  phone: "4444-5555",
  area_code2: "21",
  phone2: "1111-3333",
  email: "contact-email@somedomain.com"
}

5. Imagens do imóvel

• Importância: Imagens atrativas melhoram a apresentação do imóvel e ajudam o usuário a ter uma visão mais clara da propriedade.
• Quantidade de imagens: Consulte a seção categorias, especificamente os campos max_pictures_per_item e max_pictures_per_item_var para saber o limite máximo permitido por categoria.
• Recomendação: Evite hospedar imagens em servidores lentos, pois isso pode impactar negativamente a performance da publicação.
• Atualização de imagens: É possível adicionar ou alterar imagens após a publicação do anúncio.
• Guia de imagens: Consulte Trabalhar com imagens para obter detalhes sobre os tipos de imagens permitidas e como gerenciá-las.
• Quantidade mínima de imagens: A quantidade mínima de fotos influencia a qualidade da publicação e varia conforme o tipo de imóvel:
  • Grupo 1 (Casas/Apartamentos/Escritórios/Terrenos): 12 fotos.
  • Grupo 2 (Comerciais/Agrícolas/Sítios/Depósitos/Lotes): 6 fotos.
  • Grupo 3 (Estacionamentos): 4 fotos.

Exemplo:

{
  ....
  "pictures":[
    {"source":"http://yourServer/path/to/your/picture.jpg"},
    {"source":"http://yourServer/path/to/your/otherPicture.gif"},
    {"source":"http://yourServer/path/to/your/anotherPicture.png"}
  ]
  ...
}

Próximos passos

Antes de publicar o seu imóvel de teste, é fundamental garantir que ele esteja corretamente geolocalizado. Saiba mais em Localizar imóveis.

Atualizações de versão

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

Histórico de alterações