Trabalhando com a API de Imóveis da Austrália

Você precisa de dados imobiliários australianos integrados ao seu aplicativo esta semana: pesquise propriedades vendidas em uma região, pagine pelos resultados e aprofunde-se em uma listagem específica com detalhes completos e imagens. Ao final deste guia, você fará consultas em listas de propriedades, extrairá campos-chave, construirá URLs de imagens corretas e buscará os detalhes de uma propriedade usando a API de Imóveis da Austrália no Zyla API Hub.

O que você pode construir com a API de Imóveis da Austrália

A API de Imóveis da Austrália expõe acesso programático a:

• Pesquisa de listagens com filtros (por exemplo, canal vendido, consultas baseadas em região) através de um feed de resultados paginados.
• Informações detalhadas para uma propriedade específica por ID.
• Sugestões de autocompletar localização para construção de interfaces de busca.

Casos de uso típicos incluem: painéis de análise de mercado, CRMs internos para agências, ferramentas de comparação e precificação, e experiências de busca ciente da localização incorporadas em aplicativos de consumo.

Começando no Zyla API Hub

Abra a listagem do marketplace, inscreva-se e obtenha sua chave de API. A Zyla utiliza um modelo de assinatura + cota (não é pago por chamada). Para uso pela primeira vez, você pode iniciar um teste de 7 dias a partir da página do item:

Iniciar teste de 7 dias na API de Imóveis da Austrália

Use a chave da API no cabeçalho de Autorização como: Authorization: Bearer YOUR_API_KEY. Todas as solicitações são feitas para os caminhos da API zylalabs.com mostrados abaixo.

Visão geral dos Endpoints

1) Obter Lista de Propriedades

Método: GET

URL: https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list

Descrição: Liste propriedades com opções e filtros. Notas:

• Se o campo de página retornar um valor de 50, este é o maior número de paginação disponível.
• Você deve indicar o formato nas URLs das imagens (por exemplo, 170x32, 160x30, 114x21, 1536x800) ao renderizar fotos.

Parâmetros de solicitação (apenas os documentados):

• pageSize (string, opcional): 50
• channel (string, obrigatório): sold
• searchLocation (string, obrigatório): Sunshine Coast, QLD
• searchLocationSubtext (string, obrigatório): Região
• type (string, obrigatório): região
• page (string, opcional): 2
• sortType (string, opcional): new-desc

2) Obter Detalhes da Propriedade

Método: GET

URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details

Descrição: Obtenha informações detalhadas de uma propriedade. Nota sobre imagens: você deve indicar o formato na URL das imagens (por exemplo, 170x32, 160x30, 114x21, 1536x800).

Parâmetros de solicitação (apenas os documentados):

• id (número, obrigatório): 444325280

3) Autocompletar

Método: GET

URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete

Descrição: Retorna sugestões para autocompletar localização. A documentação afirma: “Para usar este endpoint, você deve especificar um termo a ser autocompletado.” Nenhum parâmetro de solicitação é documentado aqui; chame-o apenas com Autorização e consulte a resposta para ver os campos disponíveis.

Exemplo oficial: Obter Lista de Propriedades (cURL + JSON)

Copie, cole e execute isso para buscar listagens vendidas para a região de Sunshine Coast (página 2, mais novas primeiro). Substitua YOUR_API_KEY pela sua chave.

curl -s -X GET "https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list?pageSize=50&channel=sold&searchLocation=Sunshine+Coast%2C+QLD&searchLocationSubtext=Region&type=region&page=2&sortType=new-desc" \
-H "Authorization: Bearer YOUR_API_KEY"

Resposta JSON de exemplo oficial:

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Sales Consultant",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "main photo",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "Por que pagar uma fortuna por férias quando você pode ter seu próprio pedaço de vida estilo resort na bela Sunshine Coast.<br/>Aproveite a piscina, 2 quadras de tênis, putting green, área de churrasco à beira do rio e parque separado para as crianças.<br/><br/>Esta casa de 3 quartos está situada no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Praia de Mudjimba.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou navegação,…"

Campos que você realmente usará primeiro:

• totalResultsCount: contagem total para a consulta, útil para controles de paginação.
• resolvedQuery: ecoa o contexto da sua consulta (por exemplo, canal, página, sortType).
• tieredResults[].results[]: a lista de propriedades. De cada resultado, você pode pegar prettyUrl, channel, description e lister fields (name, contact, mainPhoto).
• lister.mainPhoto.server + tamanho da imagem + lister.mainPhoto.uri: construa URLs de imagem completas conforme descrito abaixo.

Exemplo em Python: buscar uma página e normalizar campos-chave

Este exemplo chama o mesmo endpoint de listagem, lê metadados básicos e demonstra a construção de uma URL de imagem pronta para exibição usando um segmento de tamanho necessário (por exemplo, 1536x800). Substitua YOUR_API_KEY antes de executar.

import requests

API_URL = "https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list"
params = {
"pageSize": "50",
"channel": "sold",
"searchLocation": "Sunshine Coast, QLD",
"searchLocationSubtext": "Região",
"type": "região",
"page": "2",
"sortType": "new-desc",
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(API_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

print("URL da Consulta:", data.get("prettyUrl"))
print("Total de resultados:", data.get("totalResultsCount"))

tiered = data.get("tieredResults", [])
results = []
for tier in tiered:
for item in tier.get("results", []):
lister = item.get("lister", {}) or {}
main_photo = lister.get("mainPhoto", {}) or {}

# Construa a URL da imagem inserindo um tamanho necessário (por exemplo, '1536x800') entre o servidor e a uri.
# Exemplo: https://i3.au.reastatic.net/1536x800/....../main.jpg
server = main_photo.get("server")
uri = main_photo.get("uri")
image_url = None
if server and uri:
image_url = f"{server}/1536x800{uri}"

results.append({
"prettyUrl": item.get("prettyUrl"),
"channel": item.get("channel"),
"description": item.get("description"),
"listerName": lister.get("name"),
"listerPhone": lister.get("phoneNumber") or lister.get("mobilePhoneNumber"),
"listerEmail": lister.get("email"),
"image": image_url
})

# Imprima os primeiros itens normalizados
for r in results[:3]:
print(r)

Notas:

• Imagens: você deve escolher um tamanho (por exemplo, 170x32, 160x30, 114x21, 1536x800) e inseri-lo entre as partes do servidor e da uri. Por exemplo: servidor + “/1536x800” + uri.
• Paginando: verifique o resolvedQuery.page e os resultados retornados. O maior valor de página disponível é 50; não solicite além disso.
• Timeouts, tentativas e cache são recomendados em produção. Armazene em cache sua string de consulta completa e expire conforme necessário.

Detalhes da propriedade por ID

Para buscar informações detalhadas de uma propriedade específica, chame Obter Detalhes da Propriedade com o parâmetro id obrigatório. Você receberá uma estrutura que inclui campos como prettyUrl, channel, description e informações do lister (incluindo mainPhoto com servidor e uri). Lembre-se de construir URLs de imagem inserindo seu tamanho escolhido no caminho da URL, conforme descrito acima.

Método: GET

URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details

Exemplo de parâmetros: id=444325280

Autenticação: Authorization: Bearer YOUR_API_KEY

Autocompletar para entradas de localização

Use o endpoint de Autocompletar para alimentar entradas de tipo para busca por região ou subúrbio. O endpoint retorna sugestões com campos de exibição e tipos como “região” ou “subúrbio.” A documentação indica que você deve especificar um termo a ser autocompletado, embora nenhum parâmetro seja explicitamente enumerado aqui. Chame o endpoint com seu cabeçalho de Autorização e inspecione a resposta para preencher sua interface.

Método: GET

URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete

Notas de implementação prática

• Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY.
• Canais: Os exemplos usam channel=sold. A lógica de filtragem é definida pelos parâmetros documentados do endpoint; não adicione chaves não documentadas.
• Ordenação: sortType=new-desc retorna os mais novos primeiro no exemplo acima.
• Paginando: O maior número de página disponível é 50 para a consulta dada; reflita isso em sua interface (desative Próximo quando page=50).
• Imagens: Construa a partir do servidor + “/TAMANHO” + uri (escolha um de 170x32, 160x30, 114x21, 1536x800). Não incluir um tamanho pode resultar em imagens quebradas.
• Tratamento de erros: Valide as respostas antes de acessar campos aninhados (por exemplo, tieredResults/tier/results podem estar ausentes ou vazios).
• Throttling e cotas: A Zyla utiliza um modelo de assinatura + cota. Verifique a página da API para opções de acesso e preços atuais.

Onde isso se encaixa em projetos reais

• Comparações de vendas e auxiliares de avaliação: Busque listagens vendidas para uma região, ordene as mais novas primeiro e calcule métricas comparáveis ou distribuições de preços.
• Feeds de mercado em portais de agentes: Construa um feed contínuo de propriedades vendidas recentemente com contatos de lister e imagens principais.
• Busca do consumidor: Comece os usuários com Autocompletar para “Sydney CBD” ou “Sunshine Coast, QLD” e depois pagine pelos resultados com controles claros de próximo/anterior.
• Roteamento de leads: Extraia campos de contato do lister (nome, telefone, email) para fluxos de trabalho de outreach ou enriquecimento.

Chamando a API de agentes de IA com MCP

Você pode chamar qualquer API da Zyla a partir de clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) através do endpoint MCP. Aponte sua ferramenta para a URL do MCP e inclua sua chave da API Zyla. Isso permite que os agentes busquem listagens ou detalhes dinamicamente durante uma sessão de codificação ou análise.

MCP

Dica: Envolva consultas de listagem como “ferramentas” reutilizáveis do MCP que aceitam uma searchLocation e página, e retornam objetos normalizados (prettyUrl, lister, URL da imagem). Mantenha as saídas da ferramenta pequenas para evitar inchaço de contexto em longas sessões de agentes.

Esboço do fluxo de trabalho de ponta a ponta

1. Coletar a área-alvo de um usuário usando Autocompletar (por exemplo, tipo: “região” ou “subúrbio”).
2. Enviar uma solicitação de Obter Lista de Propriedades com channel=sold, a searchLocation selecionada, searchLocationSubtext, type e (opcionalmente) page, sortType.
3. Renderizar resultados e construir imagens inserindo um segmento de tamanho entre servidor e uri.
4. Quando um usuário seleciona uma propriedade, chame Obter Detalhes da Propriedade com id para mostrar a descrição completa e informações do lister.
5. Pagine até a página 50 se necessário; desative Próximo além disso.

Dicas de solução de problemas

• Resultados vazios: Verifique se os parâmetros obrigatórios—channel, searchLocation, searchLocationSubtext e type—correspondem exatamente ao que sua interface capturou (por exemplo, Região vs Subúrbio).
• Imagens quebradas: Certifique-se de que você inseriu um tamanho válido (por exemplo, “/1536x800” antes da uri) e incluiu a barra inicial antes do caminho da uri.
• Ordem de classificação inesperada: Confirme sortType=new-desc se você quiser os resultados mais novos primeiro.
• Erros de paginação: Não solicite além da página 50; use totalResultsCount para calibrar o total de páginas em sua interface.

FAQ

Como faço para autenticar solicitações?
Inclua o cabeçalho: Authorization: Bearer YOUR_API_KEY em cada solicitação para os endpoints da API zylalabs.com.

Há um plano gratuito?
Não há plano gratuito. Você pode iniciar um teste de 7 dias a partir da página de listagem do marketplace. Verifique a página da API para opções de acesso e preços atuais.

Qual é a página máxima que posso solicitar?
Se o campo de página retornar um valor de 50, este é o maior número de paginação disponível para essa consulta. Não solicite além da página 50.

Como faço para construir URLs de imagens de propriedades?
Use lister.mainPhoto.server, insira um tamanho como 1536x800, e então anexe lister.mainPhoto.uri. Exemplo: servidor + “/1536x800” + uri.

Quais parâmetros são obrigatórios para a pesquisa de listagens?
channel, searchLocation, searchLocationSubtext e type são obrigatórios. pageSize, page e sortType são opcionais conforme o exemplo documentado.

Pronto para enviar sua integração? Inscreva-se e pegue sua chave na listagem do marketplace, então copie o cURL acima para obter resultados em minutos: Iniciar teste de 7 dias na API de Imóveis da Austrália

Resposta oficial da API

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Consultor de Vendas",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "foto principal",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "Por que pagar uma fortuna por férias quando você pode ter seu próprio pedaço de vida estilo resort na bela Sunshine Coast.<br/>Aproveite a piscina, 2 quadras de tênis, putting green, área de churrasco à beira do rio e parque separado para as crianças.<br/><br/>Esta casa de 3 quartos está situada no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Praia de Mudjimba.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou navegação,…

Resposta oficial da API

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Consultor de Vendas",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "foto principal",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "Por que pagar uma fortuna por férias quando você pode ter seu próprio pedaço de vida estilo resort na bela Sunshine Coast.<br/>Aproveite a piscina, 2 quadras de tênis, putting green, área de churrasco à beira do rio e parque separado para as crianças.<br/><br/>Esta casa de 3 quartos está situada no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Praia de Mudjimba.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou navegação,…