होम
ब्लॉग
Como obter a lista de propriedades
ब्लॉग

Como obter a lista de propriedades

Como obter a lista de propriedades

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:

Ilustração: Como obter a lista de propriedades
  • 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:

  1. Abra a página da API Australia Realty no Zyla.
  2. Clique em Inscrever-se ou Começar Teste Gratuito (quando disponível) para obter sua chave.
  3. 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)

  1. Autocomplete a entrada do usuário para capturar type=suburb ou type=region e o texto de exibição.
  2. 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).
  3. Renderize tieredResults[0].results e um pager a partir de totalResultsCount e page.
  4. Construa URLs de imagem por item usando mainPhoto.server + "/1536x800" + mainPhoto.uri.

Aprofundar-se em uma única propriedade

  1. De um resultado, navegue com prettyUrl na roteação do seu aplicativo e armazene/exiba informações básicas.
  2. Chame Obter Detalhes da Propriedade com id para uma descrição mais profunda e os contatos do listador.
  3. 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:

MCP

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,…

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

अभी आज़माएँ!

संबंधित पोस्ट्स

साइट ट्रैफ़िक एपीआई के लिए उपयोग के मामले

साइट ट्रैफ़िक एपीआई के लिए उपयोग के मामले

आपके हितधारक एक डैशबोर्ड चाहते हैं जो दिखाता है कि ट्रैफ़िक कहाँ से आता है, कौन से देश महत्वपूर्ण हैं, और आगंतुक कितने स...

 वीडियो डाउनलोड करने के लिए API

वीडियो डाउनलोड करने के लिए API

आपको प्रोग्रामेटिक रूप से वीडियो फ़ाइलों को डाउनलोड करने के लिए एक API की आवश्यकता है और इसे इस सप्ताह भेजना है। इस गाइड...

 फोन सत्यापन के लिए API

फोन सत्यापन के लिए API

आपके पास फॉर्म, चेकआउट और CRM से आने वाले फोन नंबर हैं, और आपको यह जानने की आवश्यकता है कि क्या वे मान्य हैं, मोबाइल हैं...

 कैसे प्रॉपर्टीज़ सूची प्राप्त करें

कैसे प्रॉपर्टीज़ सूची प्राप्त करें

आपको ऑस्ट्रेलियाई प्रॉपर्टीज़ की एक साफ, फ़िल्टर करने योग्य सूची प्राप्त करने की आवश्यकता है और इसे इस सप्ताह भेजना है।...

 कार्ड चेकर्स API के साथ काम करना

कार्ड चेकर्स API के साथ काम करना

आपको इस सप्ताह कार्ड BINs को मान्य और समृद्ध करना है ताकि आप जोखिम भरे भुगतानों को चिह्नित कर सकें, लेनदेन को सही ढंग से...

 वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए एपीआई

वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए एपीआई

आपको इस सप्ताह एक सामाजिक मीडिया वीडियो यूआरएल को डाउनलोड करने योग्य फ़ाइल में बदलने के लिए एक विश्वसनीय तरीके की आवश्यक...

खोजें

संबंधित पोस्ट्स

हाल की पोस्ट्स