Necesitas datos de bienes raíces australianos integrados en tu aplicación esta semana: busca propiedades vendidas en una región, pagina a través de los resultados y profundiza en un listado específico con todos los detalles e imágenes. Al final de esta guía, consultarás listas de propiedades, extraerás campos clave, construirás URLs de imágenes correctas y obtendrás los detalles de una propiedad utilizando la API de Australia Realty en Zyla API Hub.
Lo que puedes construir con la API de Australia Realty
La API de Australia Realty expone acceso programático a:
- Búsqueda de listados con filtros (por ejemplo, canal vendido, consultas basadas en región) a través de un feed de resultados paginados.
- Información detallada para una propiedad específica por ID.
- Sugerencias de autocompletado de ubicación para construir interfaces de búsqueda.
Los casos de uso típicos incluyen: paneles de análisis de mercado, CRMs internos para agencias, herramientas de comparación y precios, y experiencias de búsqueda con geolocalización integradas en aplicaciones para consumidores.
Comenzando en Zyla API Hub
Abre la lista del mercado, suscríbete y obtén tu clave API. Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Para el primer uso, puedes iniciar una prueba de 7 días desde la página del artículo:
Iniciar prueba de 7 días en la API de Australia Realty
Usa la clave API en el encabezado de autorización como: Authorization: Bearer YOUR_API_KEY. Todas las solicitudes se realizan a las rutas de API de zylalabs.com que se muestran a continuación.
Resumen de endpoints
1) Obtener lista de propiedades
Método: GET
URL: https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list
Descripción: Lista propiedades con opciones y filtros. Notas:
- Si el campo de página devuelve un valor de 50, este es el número de paginación más alto disponible.
- Debes indicar el formato en las URLs de las imágenes (por ejemplo, 170x32, 160x30, 114x21, 1536x800) al renderizar fotos.
Parámetros de solicitud (solo los documentados):
- pageSize (string, opcional): 50
- channel (string, requerido): sold
- searchLocation (string, requerido): Sunshine Coast, QLD
- searchLocationSubtext (string, requerido): Región
- type (string, requerido): region
- page (string, opcional): 2
- sortType (string, opcional): new-desc
2) Obtener detalles de la propiedad
Método: GET
URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details
Descripción: Obtén información detallada de una propiedad. Nota sobre las imágenes: debes indicar el formato en la URL de las imágenes (por ejemplo, 170x32, 160x30, 114x21, 1536x800).
Parámetros de solicitud (solo los documentados):
- id (número, requerido): 444325280
3) Autocompletar
Método: GET
URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete
Descripción: Devuelve sugerencias para autocompletado de ubicación. La documentación indica: “Para usar este endpoint debes especificar un término a autocompletar.” No se documentan parámetros de solicitud aquí; llámalo solo con la autorización y consulta la respuesta para ver los campos disponibles.
Ejemplo oficial: Obtener lista de propiedades (cURL + JSON)
Copia, pega y ejecuta esto para obtener listados vendidos para la región de Sunshine Coast (página 2, más recientes primero). Reemplaza YOUR_API_KEY con tu clave.
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"Muestra de 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 propio pedazo 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 infantil separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y amigable con 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,…"
Campos que realmente usarás primero:
- totalResultsCount: conteo total para la consulta, útil para controles de paginación.
- resolvedQuery: refleja el contexto de tu consulta (por ejemplo, canal, página, sortType).
- tieredResults[].results[]: la lista de propiedades. De cada resultado, puedes tomar prettyUrl, channel, description y lister fields (name, contact, mainPhoto).
- lister.mainPhoto.server + tamaño de imagen + lister.mainPhoto.uri: construye URLs de imágenes completas como se describe a continuación.
Ejemplo en Python: obtener una página y normalizar campos clave
Este ejemplo llama al mismo endpoint de listados, lee metadatos básicos y demuestra cómo construir una URL de imagen lista para mostrar utilizando un segmento de tamaño requerido (por ejemplo, 1536x800). Reemplaza YOUR_API_KEY antes de ejecutar.
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": "Region",
"type": "region",
"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("Query URL:", data.get("prettyUrl"))
print("Total results:", 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 {}
# Construir URL de imagen insertando un tamaño requerido (por ejemplo, '1536x800') entre server y uri.
# Ejemplo: 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
})
# Imprimir los primeros elementos normalizados
for r in results[:3]:
print(r)Notas:
- Imágenes: debes elegir un tamaño (por ejemplo, 170x32, 160x30, 114x21, 1536x800) e insertarlo entre las partes de server y uri. Por ejemplo: server + “/1536x800” + uri.
- Paginación: verifica resolvedQuery.page y los resultados devueltos. El valor de página más alto disponible es 50; no solicites más allá de eso.
- Se recomiendan timeouts, reintentos y cachés en producción. Cachea por tu cadena de consulta completa y expira según sea necesario.
Detalles de la propiedad por ID
Para obtener información detallada de una propiedad específica, llama a Obtener detalles de la propiedad con el parámetro id requerido. Recibirás una estructura que incluye campos como prettyUrl, channel, description y la información del lister (incluyendo mainPhoto con server y uri). Recuerda construir URLs de imágenes insertando tu tamaño elegido en la ruta de la URL como se describió anteriormente.
Método: GET
URL: https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details
Ejemplo de parámetros: id=444325280
Autenticación: Authorization: Bearer YOUR_API_KEY
Autocompletar para entradas de ubicación
Utiliza el endpoint de Autocompletar para potenciar entradas de tipoahead para buscar por región o suburbio. El endpoint devuelve sugerencias con campos de visualización y tipos como “región” o “suburbio.” La documentación indica que debes especificar un término a autocompletar, aunque no se enumeran explícitamente parámetros aquí. Llama al endpoint con tu encabezado de autorización e inspecciona la respuesta para poblar tu interfaz de usuario.
Método: GET
URL: https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete
Notas de implementación práctica
- Autenticación: Siempre envía Authorization: Bearer YOUR_API_KEY.
- Canales: Los ejemplos utilizan channel=sold. La lógica de filtrado está definida por los parámetros documentados del endpoint; no agregues claves no documentadas.
- Ordenamiento: sortType=new-desc devuelve los más nuevos primero en el ejemplo anterior.
- Paginación: El número de página más alto disponible es 50 para la consulta dada; refleja esto en tu interfaz de usuario (desactiva Siguiente cuando page=50).
- Imágenes: Construye a partir de server + “/SIZE” + uri (elige uno de 170x32, 160x30, 114x21, 1536x800). No incluir un tamaño puede resultar en imágenes rotas.
- Manejo de errores: Valida las respuestas antes de acceder a campos anidados (por ejemplo, tieredResults/tier/results pueden estar ausentes o vacíos).
- Limitaciones y cuotas: Zyla utiliza un modelo de suscripción + cuota. Consulta la página de la API para opciones de acceso y precios actuales.
Dónde encaja esto en proyectos reales
- Comparaciones de ventas y herramientas de valoración: Extrae listados vendidos para una región, ordena los más nuevos primero y calcula métricas comparables o distribuciones de precios.
- Feeds de mercado en portales de agentes: Construye un feed continuo de propiedades vendidas recientes con contactos de lister e imágenes destacadas.
- Búsqueda para consumidores: Comienza a los usuarios con Autocompletar para “Sydney CBD” o “Sunshine Coast, QLD” y luego pagina a través de los resultados con controles claros de siguiente/anterior.
- Enrutamiento de leads: Extrae campos de contacto del lister (nombre, teléfono, correo electrónico) para flujos de trabajo de divulgación o enriquecimiento.
Llamando a la API desde agentes de IA con MCP
Puedes llamar a cualquier API de Zyla desde clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) a través del endpoint MCP. Apunta tu herramienta a la URL de MCP e incluye tu clave API de Zyla. Esto permite a los agentes obtener listados o detalles dinámicamente durante una sesión de codificación o análisis.
Consejo: Envuelve las consultas de listados como “herramientas” reutilizables de MCP que acepten un searchLocation y página, y luego devuelvan objetos normalizados (prettyUrl, lister, URL de imagen). Mantén las salidas de herramientas pequeñas para evitar la sobrecarga de contexto en sesiones largas de agentes.
Esquema de flujo de trabajo de extremo a extremo
- Recoge el área objetivo de un usuario utilizando Autocompletar (por ejemplo, tipo: “región” o “suburbio”).
- Envía una solicitud de Obtener lista de propiedades con channel=sold, la searchLocation seleccionada, searchLocationSubtext, type y (opcionalmente) page, sortType.
- Renderiza resultados y construye imágenes insertando un segmento de tamaño entre server y uri.
- Cuando un usuario selecciona una propiedad, llama a Obtener detalles de la propiedad con id para mostrar la descripción completa y la información del lister.
- Pagina hasta la página 50 si es necesario; desactiva Siguiente más allá de eso.
Consejos de solución de problemas
- Resultados vacíos: Verifica que los parámetros requeridos—channel, searchLocation, searchLocationSubtext y type—coincidan exactamente con lo que tu interfaz de usuario capturó (por ejemplo, Región vs Suburbio).
- Imágenes rotas: Asegúrate de haber insertado un tamaño válido (por ejemplo, “/1536x800” antes del uri) e incluido la barra inclinada inicial antes de la ruta uri.
- Orden de clasificación inesperado: Confirma sortType=new-desc si deseas los resultados más nuevos primero.
- Errores de paginación: No solicites más allá de la página 50; usa totalResultsCount para calibrar el total de páginas en tu interfaz de usuario.
FAQ
¿Cómo autentico las solicitudes?
Incluye el encabezado: Authorization: Bearer YOUR_API_KEY en cada solicitud a los endpoints de la API de zylalabs.com.
¿Hay un plan gratuito?
No hay un plan gratuito. Puedes iniciar una prueba de 7 días desde la página de listado del mercado. Consulta la página de la API para opciones de acceso y precios actuales.
¿Cuál es la página máxima que puedo solicitar?
Si el campo de página devuelve un valor de 50, este es el número de paginación más alto disponible para esa consulta. No solicites más allá de la página 50.
¿Cómo construyo URLs de imágenes de propiedades?
Usa lister.mainPhoto.server, inserta un tamaño como 1536x800, luego agrega lister.mainPhoto.uri. Ejemplo: server + “/1536x800” + uri.
¿Qué parámetros son requeridos para la búsqueda de listados?
channel, searchLocation, searchLocationSubtext y type son requeridos. pageSize, page y sortType son opcionales según el ejemplo documentado.
¿Listo para enviar tu integración? Suscríbete y obtén tu clave desde la lista del mercado, luego copia el cURL anterior para obtener resultados en minutos: Iniciar prueba de 7 días en la API de Australia Realty
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 propio pedazo 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 infantil separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y amigable con 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 propio pedazo 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 infantil separado para los niños.<br/><br/>Este townhouse de 3 habitaciones está situado en el resort seguro y amigable con 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,…
