Trabajando con la API de Datos de Zillow en Tiempo Real

Tu equipo necesita un inventario de bienes raíces en vivo que puedas filtrar por ciudad, límites del mapa o un polígono dibujado, y lo necesitas esta semana. Al final de esta guía, podrás obtener listados al estilo Zillow en tiempo real por ubicación, coordenadas o un polígono personalizado utilizando la API de Datos de Zillow en Tiempo Real en Zyla API Hub, analizar los campos que te interesan (precio, habitaciones, baños, zestimate, dirección, coordenadas) y conectarlo a tu aplicación o a un flujo de trabajo de agente de IA.

Lo que puedes construir con la API de Datos de Zillow en Tiempo Real

La API de Datos de Zillow en Tiempo Real expone puntos finales de búsqueda que devuelven listados de propiedades y metadatos como zpid, dirección, coordenadas, tipo de vivienda, precio y moneda, Zestimate y rent Zestimate, valores tasados, habitaciones, baños, área habitable, días en Zillow, y más. Puedes:

Ilustración: Trabajando con la API de Datos de Zillow en Tiempo Real

Buscar por una ubicación legible por humanos como “Los Ángeles, CA”.
Buscar dentro de un radio alrededor de latitud/longitud.
Buscar dentro de un polígono arbitrario para coincidir con formas de vecindarios complejos o áreas de servicio personalizadas.

Las integraciones típicas incluyen aplicaciones de búsqueda para compradores/inquilinos, paneles de agentes con filtros geográficos, análisis de propiedades y herramientas de comparaciones instantáneas.

Comenzando en Zyla API Hub

Abre el listado de la API de Datos de Zillow en Tiempo Real en Zyla API Hub y suscríbete para comenzar a hacer solicitudes. Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Para esta API, puedes comenzar con una prueba de 7 días directamente desde la página de listado. Una cuenta y una clave de API funcionan en todo el catálogo de más de 10,000 APIs públicas.

Comienza la prueba de 7 días en la API de Datos de Zillow en Tiempo Real

Después de suscribirte, recibirás una clave de API. Autentica cada solicitud con el encabezado: Authorization: Bearer YOUR_API_KEY.

Puntos finales que usarás

A continuación se presentan los tres puntos finales disponibles. Cada uno devuelve JSON con un estado, request_id, parámetros de solicitud devueltos y un array de datos de listados. Solo usa los parámetros mostrados para cada punto final.

1) Buscar — por ciudad, vecindario, condado o código postal

Usa esto cuando tengas un nombre de lugar legible por humanos. Soporta paginación opcional y filtrado por estado de la vivienda.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
Parámetros de consulta requeridos:
- location (string): p.ej., Los Ángeles, CA
Parámetros de consulta opcionales:
- page (string): número de página
- home_status (string): p.ej., FOR_SALE

cURL (ejemplo oficial):

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search?location=Los+Angeles%2C+CA&page=2&home_status=FOR_SALE" \
-H "Authorization: Bearer YOUR_API_KEY"

JSON (ejemplo oficial):

{
"status": "OK",
"request_id": "81fc95df-86f3-44b7-a3dc-1d81abcd7a97",
"parameters": {
"page": 2,
"home_status": "FOR_SALE",
"sort": "DEFAULT",
"listing_type": "BY_AGENT",
"location": "Los Angeles, CA"
},
"data": [
{
"zpid": "136702358",
"homeStatus": "FOR_SALE",
"detailUrl": "https://www.zillow.com/homedetails/24425-Woolsey-Canyon-Rd-SPC-39-Canoga-Park-CA-91304/136702358_zpid/",
"address": "24425 Woolsey Canyon Rd Spc 39, Canoga Park, CA 91304",
"streetAddress": "24425 Woolsey Canyon Rd Spc 39",
"city": "Canoga Park",
"state": "CA",
"country": "USA",
"zipcode": "91304",
"latitude": 34.235462,
"longitude": -118.661224,
"homeType": "MANUFACTURED",
"price": 99500,
"currency": "USD",
"zestimate": 178100,
"rentZestimate": 3439,
"taxAssessedValue": 21901,
"bathrooms": 2,
"bedrooms": 4,
"livingArea": 1818,
"daysOnZillow": 5,
"isFeatured": false,
"isPreforeclosureAuction": false,
"timeOnZillow": 498172000,
"isNonOwnerOccupied": true,
"isPremierBuilder": false,
"isZillowOwned": false,
"unit": "Spc 39",
"isShowcaseListing": false,
"listingSubType": {
"is_FSBA": true
},
"palsId": "3007_SR26162189",
"id": "136702358",
"rawHomeStatusCd": "ForSale",
"marketingStatusSimplifiedCd": "For Sale by Agent",
"imgSrc": "https://photos.zillowstatic.com/fp/1d8602169bd359c27caa6d6e25cdf662-p_e.jpg",
"hasImage": true,
"statusType": "FOR_SALE",
"statusText": "Casa en venta",
"countryCurrency": "$",
"unformattedPrice": 99500,
"addressStreet": "24425 Woolsey Canyon Rd Spc 39",
"addressCity": "Canoga Park",
"addressState": "CA",
"addressZipcode": "91304",
"isUndisclosedAddress": false,
"shouldShowRequestOnPrice": false,
"beds": 4,
"baths": 2,
"area": 1818,
"latLong": {
"latitude": 34.235462,
"longitude": -118.661224
},
"flexFieldText": "5 días en…

Lo que más usarás:

zpid (string): identificador de propiedad estable.
detailUrl (string): enlace profundo para ver la página del listado.
price, currency, zestimate, rentZestimate (números y moneda): contexto de precios.
bedrooms, bathrooms, livingArea, area (números): especificaciones de la vivienda; area/livingArea están en pies cuadrados cuando están presentes.
latitude, longitude y latLong: mapeo.
homeStatus/statusType/statusText: señales de estado del listado (p.ej., FOR_SALE).
daysOnZillow/timeOnZillow: frescura del mercado.

Ejemplo en Python (requests):

import requests

url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search"
params = {
"location": "Los Angeles, CA",
"page": "2",
"home_status": "FOR_SALE"
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, headers=headers, params=params, timeout=30)
resp.raise_for_status()
payload = resp.json()

print("Status:", payload.get("status"))
print("Request ID:", payload.get("request_id"))

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
price = item.get("price")
beds = item.get("bedrooms") or item.get("beds")
baths = item.get("bathrooms") or item.get("baths")
lat = item.get("latitude") or (item.get("latLong") or {}).get("latitude")
lng = item.get("longitude") or (item.get("latLong") or {}).get("longitude")
detail = item.get("detailUrl")
print(f"[{zpid}] {addr} | ${price} | {beds} bd / {baths} ba | ({lat}, {lng}) -> {detail}")

2) Buscar por Coordenadas — punto central + diámetro

Usa esto para encontrar propiedades dentro de un área circular alrededor de una latitud/longitud central. Útil para características de “cerca de mí” o proximidad a un lugar.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
Parámetros de consulta requeridos:
- long (string): longitud
- lat (string): latitud
Parámetros de consulta opcionales:
- diameter (string): diámetro de búsqueda

cURL:

Ejemplo JSON:

Notas:

Las coordenadas están en grados decimales. Asegúrate de codificar en URL los parámetros de consulta.
La carga de datos incluye los mismos campos básicos que el punto final de búsqueda.

3) Buscar por Polígono — límites de área personalizados

Usa esto cuando un círculo no sea lo suficientemente preciso. Proporciona un polígono como una secuencia de pares de coordenadas “long lat” separados por comas. Esto es ideal para coincidir con vecindarios irregulares, zonas escolares o territorios de servicio. El punto final admite todos los filtros y opciones disponibles en Zillow.com.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
Parámetros de consulta requeridos:
- polygon (string): pares “longitud latitud” ordenados separados por comas (ver ejemplo)

cURL:

Ejemplo JSON:

Notas:

Formatea cada vértice como “longitud latitud”. Separa los vértices con comas.
Codifica en URL la cadena del polígono. El ejemplo anterior muestra la codificación adecuada usando “+” para espacios y “%2C” para comas dentro del valor del parámetro.

Detalles prácticos de implementación

Autenticación: Siempre incluye Authorization: Bearer YOUR_API_KEY.
Paginación: Usa el parámetro page en los puntos finales de búsqueda y paginación para obtener páginas de resultados subsiguientes. La API devuelve la página que solicitaste en el objeto de parámetros.
Unidades y moneda:
- la moneda es típicamente "USD". countryCurrency puede incluir el símbolo "$".
- los valores de livingArea/area y lotAreaValue aparecen en pies cuadrados cuando lotAreaUnit es "sqft".
Filtrado: home_status puede configurarse como FOR_SALE (como se muestra). Se admiten filtros adicionales en Zillow.com; consulta la página de la API para opciones actuales.
Coordenadas: la latitud/longitud son grados decimales.
Cacheo: Para feeds de listados que cambian con frecuencia (daysOnZillow, actualizaciones de precios), agrega un cacheo de corta duración y una actualización condicional en las interacciones del usuario.
Enlaces profundos: detailUrl puede abrir la página del listado en una vista web o navegador externo.
Cuotas: El acceso es por suscripción + cuota. Consulta la página de la API para opciones de acceso y precios actuales.

Casos de uso del mundo real que puedes implementar rápidamente

Página de búsqueda para compradores: Comienza con Buscar por ubicación, luego cambia a Buscar por Polígono cuando los usuarios dibujen en un mapa. Muestra precio, habitaciones, baños y vincula cada tarjeta a detailUrl.
CMA/comparaciones de agentes: Usa Buscar por Coordenadas para recopilar listados dentro de un diámetro de 1–2 millas alrededor de una propiedad sujeta; muestra zestimate y rentZestimate para un contexto de valoración rápida.
Explorador de vecindarios: Predefine límites de polígono para cada vecindario y consulta con Buscar por Polígono para asegurar que los resultados respeten las fronteras locales e irregulares.
“Cerca de mí” móvil: Con permiso de ubicación, llama a Buscar por Coordenadas usando la posición GPS del usuario con un diámetro pequeño para mantener los resultados relevantes.

Llamando a esta API desde un agente de IA a través de MCP

También puedes acceder a estos puntos finales desde un cliente compatible con MCP. Dirige tu agente al punto final de Zyla MCP y usa tu misma clave de API:

MCP

Punto final: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

Desde tu cliente MCP, emite llamadas de herramientas que realicen solicitudes HTTPS GET a las mismas URL de hub mostradas arriba.
Envía el encabezado Authorization: Bearer YOUR_API_KEY exactamente como en los ejemplos de curl.
Mantén las cadenas de consulta idénticas a las muestras aquí para un comportamiento estable en los prompts y flujos de agentes.

Solución de problemas y precauciones

Errores 401 o 403: Confirma que el encabezado Authorization está presente y que la clave de API es válida para tu suscripción.
Array de datos vacío: Verifica que tus filtros no sean demasiado restrictivos; intenta eliminar home_status o ajustar el polígono/diámetro.
Polígono mal formado: Asegúrate de que cada punto sea “long lat”, no “lat long”, y que toda la cadena esté codificada en URL.
Confusión de paginación: La API devuelve la página solicitada bajo parameters.page. Incrementa la página para recorrer conjuntos de resultados.
Codificación de espacios y comas: En URLs, los espacios deben codificarse como + o %20, y las comas como %2C dentro de los valores de los parámetros de consulta.

FAQ

¿Cómo autentico las solicitudes?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.

¿Puedo filtrar por estado del listado?
Sí. Establece home_status=FOR_SALE en búsquedas de Search y coordenadas/polígono donde se admitan.

¿Cómo busco dentro de una forma de vecindario?
Usa el punto final Buscar por Polígono con una lista ordenada de pares “longitud latitud” que tracen el límite del vecindario, codificada en URL.

¿Qué unidades utilizan los valores de área?
Cuando lotAreaUnit es "sqft", lotAreaValue está en pies cuadrados. Los valores de livingArea/area también están en pies cuadrados cuando están presentes.

¿Dónde puedo ver opciones de acceso y cuotas?
Consulta la página de la API en Zyla API Hub para opciones de acceso y precios actuales. Las suscripciones utilizan un modelo de cuota, no pago por llamada.

¿Listo para integrar la búsqueda de propiedades en tiempo real en tu aplicación? Comienza tu prueba de 7 días y obtén tu clave de API aquí: Comienza la prueba de 7 días en la API de Datos de Zillow en Tiempo Real. Usa una cuenta y clave en todo el catálogo de Zyla API Hub y entrega rápidamente tus características de bienes raíces.