Você precisa buscar uma lista limpa e filtrável de propriedades australianas e enviá-la esta semana. Ao final deste guia, você será capaz de consultar um feed de propriedades reais, paginar pelos resultados, extrair detalhes de listagens que você se importa e, opcionalmente, aprofundar-se em uma única propriedade — tudo via uma chave de API no Zyla API Hub.
O que você pode construir com a lista de propriedades
A API Australia Realty retorna listas estruturadas de propriedades em toda a Austrália com metadados como contagens totais de resultados, localidades de pesquisa resolvidas e listagens em camadas. Os usos típicos incluem:
- Construir uma interface de pesquisa para explorar o histórico de vendas ou aluguel por região ou subúrbio.
- Gerar resumos diários de propriedades ou alertas classificados por novas listagens.
- Enriquecer painéis internos com contagens de listagens e buscas cientes de paginação.
Este post foca no endpoint “Obter Lista de Propriedades” para retornar uma página de listagens com filtros e ordenação, e mostra como recuperar detalhes para uma propriedade específica quando você precisar deles.
Começando no Zyla API Hub
No Zyla, você usa uma única conta, uma única chave de API e um modelo de assinatura + cota para cada API. Para a API Australia Realty, você pode começar com um teste de 7 dias ou 50 solicitações, dependendo das opções de acesso atuais. Não há Plano Gratuito; verifique a página da API para opções de acesso e preços atuais.
Passos:
- Abra a página da API Australia Realty no Zyla.
- Clique em Inscrever-se ou Começar Teste Gratuito (quando disponível) para obter sua chave.
- Chame os endpoints com o cabeçalho Authorization: Bearer SUA_CHAVE_API.
Visão geral da API Australia Realty
A API Australia Realty expõe endpoints para:
- Listar propriedades com filtros e ordenação (Obter Lista de Propriedades).
- Buscar informações detalhadas para uma propriedade específica (Obter Detalhes da Propriedade).
- Autocomplete localidades para impulsionar a experiência de pesquisa (Autocomplete).
Você trabalhará com URLs reais do Hub no Zyla. Não adicione parâmetros não documentados. Ao renderizar imagens dos resultados das listagens, você deve especificar o tamanho alvo diretamente no caminho da URL da imagem (por exemplo, 170x32, 160x30, 114x21, 1536x800).
Endpoint: Obter Lista de Propriedades
Liste propriedades com opções e filtros. Use isso para pesquisar por localidade, mudar de canal (por exemplo, vendido), controlar a ordenação e paginar.
- Método: GET
- URL: https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list
Parâmetros da solicitação
- canal (string, obrigatório): vendido
- localidadeDePesquisa (string, obrigatório): Sunshine Coast, QLD
- subtextoLocalidadeDePesquisa (string, obrigatório): Região
- tipo (string, obrigatório): região
- tamanhoDaPagina (string, opcional): 50
- pagina (string, opcional): 2
- tipoDeOrdenacao (string, opcional): novo-desc
Nota sobre paginação: Se o campo da página retornar um valor de 50, esse é o maior número de página disponível para a consulta atual.
Exemplo oficial de cURL
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 SUA_CHAVE_API"Resposta JSON 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 infantil separado para as crianças.<br/><br/>Este townhouse de 3 quartos está situado no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Mudjimba Beach.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou passeios de barco,…O que ler na resposta
- totalResultsCount: total de listagens correspondentes em todas as páginas, útil para controles de paginação.
- resolvedLocalities e resolvedQuery: a interpretação do servidor da sua pesquisa (localidade, canal, página, ordenação).
- tieredResults[0].count e tieredResults[0].results: as listagens na página atual.
- Cada result.lister contém informações de contato da agência e mainPhoto. Para solicitar uma imagem, inclua um tamanho suportado no caminho da URL. Por exemplo: servidor + "/1536x800" + uri.
Requisito de dimensionamento de imagem: Você deve indicar o formato (tamanho) na URL da imagem. Exemplos suportados incluem 170x32, 160x30, 114x21, 1536x800. Por exemplo: https://i3.au.reastatic.net/1536x800/ca783e0....../main.jpg
Exemplo em Python: buscar e analisar uma lista de propriedades
Este trecho chama o endpoint exato acima, imprime a contagem total de resultados e, em seguida, itera o primeiro nível de resultados para extrair alguns campos práticos.
import requests
API_KEY = "SUA_CHAVE_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": "novo-desc",
}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
print("Total de resultados:", data.get("totalResultsCount"))
tiers = data.get("tieredResults", [])
if tiers:
tier0 = tiers[0]
print("Listagens nesta página:", tier0.get("count"))
for item in tier0.get("results", []):
pretty = item.get("prettyUrl")
channel = item.get("channel")
lister = item.get("lister", {})
agent = lister.get("name")
main_photo = lister.get("mainPhoto", {})
server = main_photo.get("server")
uri = main_photo.get("uri")
# Construa uma URL de imagem 1536x800 conforme exigido pela regra de formato de imagem da API.
image_url = None
if server and uri:
image_url = f"{server}/1536x800{uri}"
print({
"prettyUrl": pretty,
"channel": channel,
"agent": agent,
"image": image_url
})Notas práticas de integração
- Paginando: Use o parâmetro de página para iterar. Se o campo da página da resposta indicar 50, essa é a maior página para a consulta.
- Ordenação: sortType=new-desc retorna os mais novos primeiro para o canal especificado.
- Imagens: Sempre inclua um tamanho explícito no caminho. Armazene o servidor e uri, mas construa URLs específicas de tamanho ao renderizar.
- Cache: Armazene buscas pelo conjunto completo de parâmetros de consulta (incluindo página) para evitar buscar páginas não modificadas durante uma sessão.
Endpoint: Obter Detalhes da Propriedade
Quando um usuário clica em uma listagem, solicite detalhes para essa propriedade específica.
- Método: GET
- URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details
Parâmetros da solicitação
- id (número, obrigatório): 444325280
cURL
Exemplo de resposta
{"totalResultsCount":1,"results":[{"prettyUrl":"property-unit-qld-east+brisbane-444325280","standard":false,"midtier":false,"lister":{"mobilePhoneNumber":"0415648373","website":"http://www.housemark.com.au","phoneNumber":"0415648373","powerProfile":false,"name":"Isabella Palinkas","mainPhoto":{"server":"https://i3.au.reastatic.net","name":"main photo","uri":"/10082ec1487f85957c4f7062944636ee7600a93bdaf34549cb5f2705c1250f13/main.jpg"},"id":"3706692","email":"[email protected]"},"featured":false,"signature":true,"channel":"rent","description":"Bem-vindo ao 4/8 Longlands Street, East Brisbane! A poucos momentos do The Gabba e cercado por uma variedade de cafés, lojas, opções de transporte e principais comodidades, esta casa é ideal para quem busca uma vida fácil no centro da cidade.<br/><br/>Recentemente transformado com uma completa renovação interior, este belo apartamento atualizado está pronto para seus novos proprietários desfrutarem. Com pintura fresca em todo o lugar, uma nova cozinha deslumbrante, banheiro e lavanderia reformados, e novos pisos em todo o lugar, cada detalhe foi cuidadosamente modernizado. Combinando conforto, funcionalidade e apelo moderno, esta é uma oportunidade excepcional para quem busca…"}Assim como nas respostas de lista, construa URLs de imagem inserindo um tamanho suportado no caminho: servidor + "/1536x800" + uri (ou outro tamanho suportado).
Endpoint: Autocomplete
Use isso para alimentar entradas de pesquisa com regiões ou subúrbios sugeridos. Este endpoint requer que você especifique um termo a ser autocompletado; nenhum parâmetro de solicitação é documentado aqui além dessa nota. Envie seu cabeçalho de Autorização.
- Método: GET
- URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete
cURL
Exemplo de resposta
{"_embedded":{"suggestions":[{"display":{"subtext":"Region","text":"Sydney CBD, NSW"},"id":"6102b706-7216-4cde-b780-45cba0514ac5","source":{"atlasId":"6102b706-7216-4cde-b780-45cba0514ac5","name":"Sydney CBD","state":"NSW"},"type":"region"},{"display":{"subtext":"Suburb","text":"Sydney, NSW 2000"},"id":"99b291a3-bfcf-4bf9-bbaa-bdb9d89abc24-2000","source":{"atlasId":"99b291a3-bfcf-4bf9-bbaa-bdb9d89abc24","name":"Sydney","postcode":"2000","state":"NSW"},"type":"suburb"},{"display":{"subtext":"Suburb","text":"Sydney Olympic Park, NSW 2127"},"id":"19174a2e-3f53-4be4-8477-443d47249f20-2127","source":{"atlasId":"19174a2e-3f53-4be4-8477-443d47249f20","name":"Sydney Olympic Park","postcode":"2127","state":"NSW"},"type":"suburb"},{"display":{"subtext":"Region","text":"Western Sydney, NSW"},"id":"637c2a12-9141-4e1d-adfa-30bd200a49a4","source":{"atlasId":"637c2a12-9141-4e1d-adfa-30bd200a49a4","name":"Western Sydney","state":"NSW"},"type":"region"},{"display":{"subtext":"Region","text":"South Western Sydney, NSW"},"id":"0eadb86e-6345-43b6-ab6d-18e17c779817","source":{"atlasId":"0eadb86e-6345-43b6-ab6d-18e17c779817","name":"South Western Sydney","state":"NSW"},"type":"region"},{"display":{"subt…Fluxos do mundo real para enviar rapidamente
Página de pesquisa de propriedades (listagens vendidas por região)
- Autocomplete a entrada do usuário para capturar type=suburb ou type=region e o texto de exibição.
- Chame Obter Lista de Propriedades com channel=sold, type e searchLocation exatamente correspondendo à sua sugestão escolhida, e searchLocationSubtext definido adequadamente (por exemplo, Região).
- Renderize tieredResults[0].results e um pager a partir de totalResultsCount e page.
- Construa URLs de imagem por item usando mainPhoto.server + "/1536x800" + mainPhoto.uri.
Aprofundar-se em uma única propriedade
- De um resultado, navegue com prettyUrl na roteação do seu aplicativo e armazene/exiba informações básicas.
- Chame Obter Detalhes da Propriedade com id para uma descrição mais profunda e os contatos do listador.
- Reuse a regra de dimensionamento de imagem para imagens principais e miniaturas.
Atualizações diárias ou pipeline de alertas
- Agende Obter Lista de Propriedades com sortType=new-desc para as localidades alvo.
- Acompanhe o prettyUrl ou ID máximo observado por localidade para evitar duplicatas.
- Envie notificações com o nome do listador e uma URL de imagem pré-dimensionada.
Chamando a API de um agente de IA (MCP)
Se você preferir orquestrar chamadas de um ambiente de codificação de IA, o Zyla expõe um endpoint de Protocolo de Contexto de Modelo que funciona com clientes compatíveis com MCP. Configure seu cliente para chamar o endpoint MCP e use sua chave de API Zyla. Veja a documentação aqui:
Qualquer ferramenta/agente usando MCP pode então realizar as mesmas solicitações HTTP mostradas acima com o cabeçalho Authorization: Bearer e as URLs e parâmetros documentados.
Dicas de solução de problemas e integração
- Autorização: Sempre inclua Authorization: Bearer SUA_CHAVE_API. Omitir chaves adicionais não documentadas.
- Fidelidade dos parâmetros: Use apenas os parâmetros documentados para cada endpoint. Por exemplo, channel, searchLocation, searchLocationSubtext e type são obrigatórios para o exemplo de lista mostrado.
- Teto de paginação: Pare de paginar quando a resposta indicar a página 50 como a maior página para essa consulta.
- Renderização de imagem: Se uma imagem falhar ao carregar, confirme se você inseriu um tamanho suportado no caminho antes do uri.
- Cota: O uso segue assinatura + cota, não pagamento por chamada. Monitore as chamadas para permanecer dentro do seu plano atual.
FAQ
Como eu me autentico?
Envie Authorization: Bearer SUA_CHAVE_API com cada solicitação.
Quais parâmetros são necessários para obter uma lista de propriedades?
channel, searchLocation, searchLocationSubtext e type são obrigatórios. pageSize, page e sortType são opcionais.
Qual é a página máxima que posso solicitar?
Se o campo da página da resposta retornar 50, esse é o maior número de paginação disponível para essa consulta.
Como eu carrego imagens de listagem?
Use os campos lister.mainPhoto e insira um tamanho suportado no caminho: servidor + "/1536x800" + uri (ou um dos outros tamanhos documentados).
Há um plano gratuito?
Não há Plano Gratuito. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais.
Comece o teste de 7 dias na API Australia Realty para obter sua chave e enviar sua integração usando os endpoints acima.
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 infantil separado para as crianças.<br/><br/>Este townhouse de 3 quartos está situado no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Mudjimba Beach.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou passeios de barco,…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 infantil separado para as crianças.<br/><br/>Este townhouse de 3 quartos está situado no Resort seguro e fechado que aceita animais de estimação, a apenas 2 km da bela Mudjimba Beach.<br/>O Resort é cercado por um canal em dois lados, ideal para pesca ou passeios de barco,…
