Cómo obtener la lista de propiedades

Necesitas obtener una lista limpia y filtrable de propiedades australianas y enviarla esta semana. Al final de esta guía, podrás consultar un feed de propiedades reales, paginar a través de los resultados, extraer los detalles de las listas que te interesan y, opcionalmente, profundizar en una sola propiedad, todo a través de una clave API en Zyla API Hub.

Lo que puedes construir con la lista de propiedades

La API de Australia Realty devuelve listas estructuradas de propiedades en toda Australia con metadatos como el conteo total de resultados, localidades de búsqueda resueltas y listados por niveles. Los usos típicos incluyen:

• Construir una interfaz de búsqueda para explorar el historial de ventas o alquileres por región o suburbio.
• Generar resúmenes diarios de propiedades o alertas ordenadas por los listados más nuevos.
• Enriquecer paneles internos con conteos de listados y búsquedas conscientes de la paginación.

Esta publicación se centra en el endpoint “Obtener Lista de Propiedades” para devolver una página de listados con filtros y ordenamiento, y muestra cómo recuperar detalles para una propiedad específica cuando los necesites.

Comenzando en Zyla API Hub

En Zyla, utilizas una sola cuenta, una sola clave API y un modelo de suscripción + cuota para cada API. Para la API de Australia Realty, puedes comenzar con una prueba de 7 días o 50 solicitudes, dependiendo de las opciones de acceso actuales. No hay Plan Gratuito; consulta la página de la API para las opciones de acceso y precios actuales.

Pasos:

1. Abre la página de la API de Australia Realty en Zyla.
2. Haz clic en Suscribirse o Comenzar Prueba Gratuita (cuando esté disponible) para obtener tu clave.
3. Llama a los endpoints con el encabezado Authorization: Bearer YOUR_API_KEY.

Descripción general de la API de Australia Realty

La API de Australia Realty expone endpoints para:

• Listar propiedades con filtros y ordenamiento (Obtener Lista de Propiedades).
• Obtener información detallada para una propiedad específica (Obtener Detalles de Propiedad).
• Autocompletar ubicaciones para mejorar la experiencia de búsqueda (Autocompletar).

Trabajarás con URLs reales de Hub en Zyla. No añadas parámetros no documentados. Al renderizar imágenes de los resultados de listados, debes especificar el tamaño objetivo directamente en la ruta de la URL de la imagen (por ejemplo, 170x32, 160x30, 114x21, 1536x800).

Endpoint: Obtener Lista de Propiedades

Lista propiedades con opciones y filtros. Usa esto para buscar por localidad, cambiar canal (por ejemplo, vendido), controlar el ordenamiento y paginar.

• Método: GET
• URL: https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list

Parámetros de solicitud

• channel (cadena, requerido): sold
• searchLocation (cadena, requerido): Sunshine Coast, QLD
• searchLocationSubtext (cadena, requerido): Región
• type (cadena, requerido): region
• pageSize (cadena, opcional): 50
• page (cadena, opcional): 2
• sortType (cadena, opcional): new-desc

Nota sobre la paginación: Si el campo de página devuelve un valor de 50, ese es el número de página más alto disponible para la consulta actual.

Ejemplo 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 YOUR_API_KEY"

Respuesta 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 qué pagar una fortuna por vacaciones cuando puedes tener tu propia pieza de vida estilo resort en la hermosa Sunshine Coast.<br/>Aprovecha la piscina, 2 canchas de tenis, putting green, área de BBQ junto al río y un parque separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y cerrado que acepta mascotas, a solo 2 km de la hermosa playa de Mudjimba.<br/>El resort está rodeado por un canal en dos lados, ideal para pescar o navegar,…

Qué leer de la respuesta

• totalResultsCount: total de listados coincidentes en todas las páginas, útil para los controles de paginación.
• resolvedLocalities y resolvedQuery: la interpretación del servidor de tu búsqueda (localidad, canal, página, orden).
• tieredResults[0].count y tieredResults[0].results: los listados en la página actual.
• Cada result.lister contiene información de contacto de la agencia y mainPhoto. Para solicitar una imagen, incluye un tamaño soportado en la ruta de la URL. Por ejemplo: server + "/1536x800" + uri.

Requisito de tamaño de imagen: Debes indicar el formato (tamaño) en la URL de la imagen. Ejemplos soportados incluyen 170x32, 160x30, 114x21, 1536x800. Por ejemplo: https://i3.au.reastatic.net/1536x800/ca783e0....../main.jpg

Ejemplo en Python: obtener y analizar una lista de propiedades

Este fragmento llama al endpoint exacto anterior, imprime el conteo total de resultados, luego itera el primer nivel de resultados para extraer algunos campos prácticos.

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list"
params = {
"pageSize": "50",
"channel": "sold",
"searchLocation": "Sunshine Coast, QLD",
"searchLocationSubtext": "Región",
"type": "region",
"page": "2",
"sortType": "new-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("Listados en esta 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")
# Construir una URL de imagen de 1536x800 como lo requiere la regla de formato de imagen de la 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 de integración prácticas

• Paginación: Usa el parámetro de página para iterar. Si el campo de página de la respuesta indica 50, esa es la página más alta para la consulta.
• Ordenamiento: sortType=new-desc devuelve los más nuevos primero para el canal especificado.
• Imágenes: Siempre incluye un tamaño explícito en la ruta. Almacena el servidor y uri, pero construye URLs específicas de tamaño al renderizar.
• Cacheo: Cachea búsquedas por el conjunto completo de parámetros de consulta (incluyendo página) para evitar volver a obtener páginas no modificadas durante una sesión.

Endpoint: Obtener Detalles de Propiedad

Cuando un usuario hace clic en un listado, solicita detalles para esa propiedad específica.

• Método: GET
• URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details

Parámetros de solicitud

• id (número, requerido): 444325280

cURL

Ejemplo de respuesta

{"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":"¡Bienvenido a 4/8 Longlands Street, East Brisbane! A solo momentos de The Gabba y rodeado de una variedad de cafés, tiendas, opciones de transporte y servicios importantes, este hogar es ideal para aquellos que buscan una vida fácil en el centro de la ciudad.<br/><br/>Recientemente transformado con una renovación completa del interior, este hermoso departamento actualizado está listo para que sus nuevos propietarios lo disfruten. Con pintura fresca en todo, una impresionante cocina completamente nueva, baño y lavandería renovados, y nuevos pisos en todo, cada detalle ha sido modernizado cuidadosamente. Combinando comodidad, funcionalidad y atractivo moderno, esta es una oportunidad excepcional para aquellos que buscan…"}

Al igual que con las respuestas de lista, construye URLs de imágenes insertando un tamaño soportado en la ruta: server + "/1536x800" + uri (o otro tamaño soportado).

Endpoint: Autocompletar

Usa esto para alimentar entradas de búsqueda con regiones o suburbios sugeridos. Este endpoint requiere que especifiques un término a autocompletar; no se documentan aquí más parámetros de solicitud más allá de esa nota. Envía tu encabezado de autorización.

• Método: GET
• URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete

cURL

Ejemplo de respuesta

{"_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…

Flujos del mundo real para enviar rápidamente

Página de búsqueda de propiedades (listados vendidos por región)

1. Autocompletar la entrada del usuario para capturar type=suburb o type=region y el texto de visualización.
2. Llama a Obtener Lista de Propiedades con channel=sold, type y searchLocation coincidiendo exactamente con tu sugerencia elegida, y searchLocationSubtext configurado apropiadamente (por ejemplo, Región).
3. Renderiza tieredResults[0].results y un paginador a partir de totalResultsCount y page.
4. Construye URLs de imágenes por elemento usando mainPhoto.server + "/1536x800" + mainPhoto.uri.

Profundizar en una sola propiedad

1. Desde un resultado, navega con prettyUrl en el enrutamiento de tu aplicación y almacena/muestra información básica.
2. Llama a Obtener Detalles de Propiedad con id para una descripción más profunda y los contactos del lister.
3. Reutiliza la regla de tamaño de imagen para imágenes principales y miniaturas.

Actualizaciones diarias o canal de alertas

• Programa Obtener Lista de Propiedades con sortType=new-desc para las localidades objetivo.
• Rastrea el prettyUrl o ID máximo observado por localidad para evitar duplicados.
• Envía notificaciones con el nombre del lister y una URL de imagen pre-dimensionada.

Llamando a la API desde un agente de IA (MCP)

Si prefieres orquestar llamadas desde un entorno de codificación de IA, Zyla expone un endpoint de Protocolo de Contexto de Modelo que funciona con clientes compatibles con MCP. Configura tu cliente para llamar al endpoint MCP y usa tu clave API de Zyla. Consulta la documentación aquí:

MCP

Cualquier herramienta/agente que use MCP puede realizar las mismas solicitudes HTTP mostradas arriba con el encabezado Authorization: Bearer y las URLs y parámetros documentados.

Consejos de solución de problemas e integración

• Autorización: Siempre incluye Authorization: Bearer YOUR_API_KEY. Omite claves adicionales no documentadas.
• Fidelidad de parámetros: Usa solo los parámetros documentados para cada endpoint. Por ejemplo, channel, searchLocation, searchLocationSubtext y type son requeridos para el ejemplo de lista mostrado.
• Techo de paginación: Deja de paginar cuando la respuesta indique que la página 50 es la más alta para esa consulta.
• Renderizado de imágenes: Si una imagen no se carga, confirma que insertaste un tamaño soportado en la ruta antes del uri.
• Cuota: El uso sigue el modelo de suscripción + cuota, no pago por llamada. Monitorea las llamadas para mantenerte dentro de tu plan actual.

FAQ

¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY con cada solicitud.

¿Qué parámetros son requeridos para obtener una lista de propiedades?
channel, searchLocation, searchLocationSubtext y type son requeridos. pageSize, page y sortType son opcionales.

¿Cuál es la página máxima que puedo solicitar?
Si el campo de página de la respuesta devuelve 50, esa es la cifra más alta de paginación disponible para esa consulta.

¿Cómo cargo imágenes de listados?
Usa los campos lister.mainPhoto e inserta un tamaño soportado en la ruta: server + "/1536x800" + uri (o uno de los otros tamaños documentados).

¿Hay un plan gratuito?
No hay Plan Gratuito. La primera API generalmente ofrece una prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales.

Comienza una prueba de 7 días en la API de Australia Realty para obtener tu clave y enviar tu integración usando los endpoints anteriores.

Respuesta oficial de la 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": "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 qué pagar una fortuna por vacaciones cuando puedes tener tu propia pieza de vida estilo resort en la hermosa Sunshine Coast.<br/>Aprovecha la piscina, 2 canchas de tenis, putting green, área de BBQ junto al río y un parque separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y cerrado que acepta mascotas, a solo 2 km de la hermosa playa de Mudjimba.<br/>El resort está rodeado por un canal en dos lados, ideal para pescar o navegar,…

Respuesta oficial de la 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": "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 qué pagar una fortuna por vacaciones cuando puedes tener tu propia pieza de vida estilo resort en la hermosa Sunshine Coast.<br/>Aprovecha la piscina, 2 canchas de tenis, putting green, área de BBQ junto al río y un parque separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y cerrado que acepta mascotas, a solo 2 km de la hermosa playa de Mudjimba.<br/>El resort está rodeado por un canal en dos lados, ideal para pescar o navegar,…