Passos Rápidos para Publicar um Imóvel de Teste

Antes de começar, confira o Guia para Imóveis

1. Crie um usuário de teste: experimente sem custo

Para se familiarizar com o processo de publicação de imóveis e testar a API sem incorrer em custos reais, recomendamos criar um usuário de teste.

• Utilize nossa API de Usuários de Teste : para gerar um usuário com credenciais falsas que você poderá usar para realizar testes em um ambiente seguro e controlado.

2. Configure seu usuário de teste como imobiliária

Depois de criar seu usuário de teste, você pode configurá-lo como uma conta de imobiliária. Isso permitirá testar as funcionalidades específicas que o Mercado Livre oferece para o setor imobiliário.

3. Contrate um pacote de publicações (promotion pack)

Quando receber a confirmação de que ativamos seu usuário pelo canal de suporte, será necessário contratar um pacote de publicações para que você possa publicar imóveis.

4. Obter o access token do usuário de teste

Prepare suas credenciais — elas devem ser as mesmas utilizadas nos requisitos prévios para obter um access token e criar um usuário de teste. Certifique-se de ter em mãos:

• Seu Client ID.
• Seu Client Secret.
• A Redirect URI que você definiu ao criar sua aplicação.

Chamada:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me

Se o processo foi concluído corretamente, você já pode continuar com os próximos passos usando o access token gerado.

5. Publique seu imóvel

Se você chegou até aqui, já está pronto para publicar um imóvel com seu usuário de teste. Para isso, deve executar uma chamada POST à API de publicação de imóveis, incluindo todas as informações reunidas nos passos anteriores (token de acesso, categoria, atributos, localização, etc.).

Chamada:

curl --location 'https://api.mercadolibre.com/items' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "title": "Propriedade de Teste por favor não contatar",
    "listing_type_id": "silver",
    "category_id": "MLC157520",
    "currency_id": "CLP",
    "price": 100000000,
    "available_quantity": 1,
    "attributes": [
        {
            "id": "TOTAL_AREA",
            "name": "Área total",
            "value_id": null,
            "value_name": "4300 m²",
            "value_struct": {
                "number": 4300,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "4300 m²",
                    "struct": {
                        "number": 4300,
                        "unit": "m²"
                    },
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number_unit"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Vagas de estacionamento",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "value_type": "number"
        },
        {
            "id": "COVERED_AREA",
            "name": "Área útil",
            "value_id": null,
            "value_name": "390 m²",
            "value_struct": {
                "number": 390,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "390 m²",
                    "struct": {
                        "number": 390,
                        "unit": "m²"
                    },
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number_unit"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitórios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null,
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Banheiros",
            "value_id": null,
            "value_name": "5",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "5",
                    "struct": null,
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number"
        }
    ],
    "condition": "used",
    "location": {
        "address_line": "H-20, La Estrella, O'Higgins, Chile",
        "zip_code": "",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "TUxDQ0xBWmE0Y2Zm",
            "name": "La Estrella"
        },
        "state": {
            "id": "TUxDUE9IUzFjODg",
            "name": "Libertador B. O'Higgins"
        },
        "country": {
            "id": "CL",
            "name": "Chile"
        },
        "latitude": -34.2065985,
        "longitude": -71.6742634
    }
}'

Parâmetros de publicação de imóveis

6. Verifique o status da publicação

Depois de publicar o imóvel, você receberá um ID na resposta da API. Use esse ID para verificar o status da publicação por meio de uma requisição GET:

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

Parâmetros

Você pode saber mais sobre publicação e consulta de imóveis na seção Publicar imóveis.

7. Suporte

Caso precise de ajuda com algum ponto específico que não conseguiu resolver pela documentação, você pode entrar em contato com o suporte aqui, acessando com sua conta.

Para onde vamos?

Se você deseja se aprofundar nos diferentes aspectos da publicação de imóveis no Mercado Livre e otimizar o uso da nossa API, recomendamos explorar as seguintes leituras e recursos:

• Categorias e Atributos de publicação.
• Localizar Imóveis.
• Gerenciar pacotes de imóveis.
• Publicar imóveis.
• Desenvolvimentos imobiliários.
• Estatísticas de publicação.