Necesitas buscar propiedades por dirección o dibujar un límite en el mapa y obtener listados de vuelta—esta semana, no el próximo trimestre. Al final de esta guía podrás consultar datos de propiedades geolocalizadas por ciudad/código postal, por latitud/longitud precisa y por polígonos personalizados utilizando la API de Datos de Zillow en Tiempo Real en Zyla API Hub, con solicitudes copiables y un script mínimo en Python.
Lo que puedes construir con una API de propiedades centrada en geolocalización
La API de Datos de Zillow en Tiempo Real proporciona búsqueda de propiedades geolocalizadas que devuelve atributos clave de los listados incluyendo dirección, ciudad, estado, código postal, latitud, longitud, tipo de vivienda, precio (en USD), dormitorios, baños, área habitable, y más. Puedes:
- Buscar propiedades por cadena de ubicación (ciudad, condado, vecindario o código postal).
- Buscar por centro del mapa usando latitud/longitud y un diámetro en millas.
- Buscar dentro de un polígono personalizado—ideal para dibujar vecindarios o corredores de entrega en un mapa.
Las aplicaciones típicas incluyen interfaces de búsqueda de bienes raíces, mapas de “casas cerca de mí”, análisis de vecindarios, bots de alerta sobre nuevos listados EN_VENTA, y enriquecimiento de dirección a geolocalización en herramientas internas—todo basado en Geolocalización.
Comenzando en Zyla API Hub
Zyla API Hub alberga más de 10,000 APIs públicas en un solo mercado. Para usar la API de Datos de Zillow en Tiempo Real:
- Abre la página de la API y comienza una prueba de 7 días: Comienza prueba de 7 días en la API de Datos de Zillow en Tiempo Real.
- Suscríbete (suscripción + cuota; no pago por llamada). Primera API: prueba de 7 días o 50 solicitudes. Consulta la página de la API para opciones de acceso y precios actuales.
- Obtén tu clave API y envía solicitudes con el encabezado: Authorization: Bearer YOUR_API_KEY.
Puntos finales: búsqueda impulsada por geolocalización
1) Buscar (por ubicación similar a una dirección)
Usa esto cuando tengas una cadena de ubicación como una ciudad, condado, vecindario o código postal.
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- Parámetros requeridos: location (por ejemplo, “Los Ángeles, CA”)
- Parámetros opcionales: page (por ejemplo, “2”), home_status (por ejemplo, “EN_VENTA”)
cURL:
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"Ejemplo de respuesta (recortado a los campos de bloque de muestra oficiales):
{
"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 realmente usarás en la mayoría de los flujos de geolocalización:
- address, city, state, zipcode: campos de ubicación listos para mostrar.
- latitude, longitude: pin en un mapa o calcular distancia a puntos de interés.
- price y currency (USD): renderizar precio, ordenar o filtrar del lado del cliente.
- bedrooms, bathrooms, livingArea: resúmenes rápidos para tarjetas y filtros.
- detailUrl: enlace a la página del listado cuando sea necesario.
- page en parámetros: úsalo para paginar a través de resultados.
2) Buscar por Coordenadas (punto + diámetro)
Usa esto cuando tengas un centro de mapa y quieras casas dentro de un área de búsqueda circular.
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- Parámetros requeridos: long, lat
- Parámetros opcionales: diámetro
cURL:
Ejemplo de respuesta (rebanada de muestra oficial):
3) Buscar por Polígono (área dibujada personalizada)
Usa esto para buscar dentro de formas complejas o no estándar dibujadas en un mapa—ideal cuando un simple radio no es lo suficientemente preciso.
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- Parámetros requeridos: polygon (pares lng lat separados por espacios, delimitados por comas)
cURL:
Ejemplo de respuesta (rebanada de muestra oficial):
Ejemplo en Python: búsqueda de propiedades por dirección (datos de listado geocodificados)
Este script mínimo llama al punto final de Búsqueda con “Los Ángeles, CA” y imprime campos clave de geolocalización y precios.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
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": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
payload = resp.json()
print("Estado:", payload.get("status"))
print("ID de solicitud:", payload.get("request_id"))
print("Parámetros devueltos por la API:", payload.get("parameters"))
for item in payload.get("data", []):
print("---")
print("zpid:", item.get("zpid"))
print("dirección:", item.get("address"))
print("ciudad/estado/código postal:", item.get("city"), item.get("state"), item.get("zipcode"))
print("lat/long:", item.get("latitude"), item.get("longitude"))
print("tipo de vivienda:", item.get("homeType"))
print("precio:", item.get("price"), item.get("currency"))
print("dormitorios/baños/área:", item.get("bedrooms"), item.get("bathrooms"), item.get("livingArea"))
print("detailUrl:", item.get("detailUrl"))Notas prácticas que ahorran tiempo
- Autenticación: envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Paginación: page es un parámetro de cadena. Incrementalo para paginar a través de resultados; la API devuelve el valor de la página en parámetros para trazabilidad.
- Coordenadas: latitud/longitud son grados decimales; renderiza directamente en mapas web. Las distancias para la búsqueda de coordenadas utilizan el parámetro de diámetro proporcionado.
- Moneda: precio y moneda son devueltos; los ejemplos muestran USD. No asumas conversión—renderiza los valores proporcionados.
- Filtrado: home_status admite valores como EN_VENTA en estos ejemplos. Aplica un filtrado adicional del lado del cliente según sea necesario basado en los campos devueltos.
- Cacheo: muchas consultas de ubicación son cacheables detrás de una clave de ubicación+página. Limpia el caché cuando cambies filtros como home_status o cuando la frescura sea importante.
- Imágenes: imgSrc puede ser utilizado para miniaturas donde estén disponibles.
Casos de uso centrados en geolocalización que puedes enviar ahora
- Widget de “Casas cerca de mí”: llama a Buscar por Coordenadas con la geolocalización del usuario y un diámetro pequeño para una búsqueda de radio ajustado.
- Páginas de destino basadas en ciudad o código postal: llama a Buscar con la ubicación establecida en ciudad o código postal, pagina a través de, y prerenderiza tarjetas con dirección, precio y coordenadas.
- Búsqueda con límite dibujado: captura puntos de polígono de una interfaz de dibujo de mapa y llama a Buscar por Polígono para áreas de alta precisión.
- Mapas de ordenamiento por distancia o agrupamiento: usa latitud/longitud para calcular distancias del lado del cliente y agrupar marcadores.
- Enriquecimiento de detalles de listados: almacena zpid, dirección y lat/long para unir con tus propios conjuntos de datos para análisis de vecindario.
Llama a esta API desde agentes de IA a través de MCP
Si usas clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes enrutar llamadas a través del punto final MCP de Zyla y mantener tu gestión de claves centralizada. Consulta el punto de entrada MCP aquí: MCP. Configura tu agente para invocar los puntos finales HTTPS de la API de Datos de Zillow en Tiempo Real mostrados arriba, y pasa tu encabezado de autorización estándar. Esto es útil para flujos de agentes como “dibuja un polígono, luego resume los 10 principales listados EN_VENTA dentro de él.”
Lista de verificación de solución de problemas
- Errores 401 o 403: confirma que el encabezado de autorización usa Bearer YOUR_API_KEY y que la suscripción está activa.
- Sin resultados: verifica el formato de ubicación o las coordenadas del polígono (orden lng lat, pares separados por comas, espacios entre lng y lat).
- Desplazamientos del mapa: asegúrate de estar usando los campos de latitud y longitud a nivel de ítem y no los centroides de la ciudad.
- Gaps de paginación: asegúrate de incrementar la página como una cadena y detenerte cuando una página devuelva un array de datos vacío.
FAQ
¿La API devuelve latitud y longitud para cada propiedad?
Sí. Los listados incluyen campos de latitud y longitud adecuados para mapeo y cálculos de distancia.
¿Cómo busco por una ubicación de mapa precisa?
Usa Buscar por Coordenadas con long y lat (y opcionalmente diámetro) para consultar propiedades cerca de un punto.
¿Puedo buscar dentro de una forma personalizada dibujada por un usuario?
Sí. Usa Buscar por Polígono y pasa una cadena de polígono de pares de coordenadas lng lat, separadas por comas.
¿Cómo pagino a través de un gran conjunto de resultados?
Pasa page como un parámetro. La API devuelve la página en parámetros para que puedas rastrear dónde estás.
¿Hay un plan gratuito?
No hay Plan Gratuito. Puedes comenzar una prueba de 7 días (o 50 solicitudes para tu primera API). Consulta la página de la API para opciones de acceso y precios actuales.
¿Listo para enviar la búsqueda de propiedades impulsada por geolocalización? Comienza tu prueba de 7 días y obtén tu clave API aquí: Comienza prueba de 7 días en la API de Datos de Zillow en Tiempo Real. Luego conecta los puntos finales anteriores a tu mapa, backend o flujo de trabajo de agente y hazlo en vivo.
