API para buscar por coordenadas

Necesitas buscar listados de bienes raíces alrededor de una latitud/longitud precisa, dibujar un polígono en un mapa, o limitar los resultados a un código postal específico—y necesitas que funcione en tu aplicación esta semana. Al final de esta guía, podrás consultar propiedades por coordenadas, polígono o nombre de lugar utilizando la API de Datos de Zillow en Tiempo Real en Zyla API Hub, integrar resultados en tu mapa o interfaz de búsqueda, y saber cómo llamar a los mismos endpoints desde un agente de IA a través de MCP.

Qué hace esta API y por qué se adapta a la búsqueda de geolocalización

La API de Datos de Zillow en Tiempo Real devuelve datos residenciales en vivo adecuados para el descubrimiento basado en la ubicación. Puedes:

• Buscar por nombre de lugar (ciudad, condado, vecindario o código postal).
• Buscar por coordenadas geográficas usando un punto central y un diámetro.
• Buscar dentro de un polígono arbitrario para límites dibujados a medida.

Cada respuesta incluye campos que los desarrolladores realmente renderizan en un mapa o lista de resultados: zpid, address, latitude, longitude, price, homeStatus, bedrooms, bathrooms, livingArea, referencias multimedia, y más. Estos son los mismos tipos de campos que las aplicaciones utilizan para potenciar la búsqueda dibujada en el mapa, experiencias de “casas cerca de mí”, y alertas geocercadas.

Encontrarás esta API en Zyla API Hub, que ofrece más de 10,000 APIs públicas con una sola cuenta, una clave API, y un modelo de suscripción + cuota (no pago por llamada). La primera API aquí proporciona una prueba de 7 días o 50 solicitudes. Consulta la página de la API para opciones de acceso y precios actuales.

Comenzando en Zyla API Hub

Abre la lista de la API de Datos de Zillow en Tiempo Real en Zyla API Hub, haz clic en Suscribirse o Comenzar prueba de 7 días, y copia tu clave API. Todas las llamadas a continuación utilizan el encabezado:

• Authorization: Bearer YOUR_API_KEY

La plataforma utiliza suscripción + cuota. No hay Plan Gratuito; la primera API aquí incluye una prueba de 7 días o 50 solicitudes para ayudarte a construir y probar.

Endpoints que usarás para geolocalización

A continuación se presentan los tres endpoints enfocados en geolocalización. Cada uno es un GET a una URL de Zyla Hub, y cada uno devuelve una carga útil JSON con un eco de parameters y un array data de listados.

1) Buscar por Coordenadas

Utiliza esto cuando tengas un punto central y quieras listados dentro de un diámetro específico.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• Descripción: Buscar propiedades en una ubicación geográfica específica, por un punto de latitud, longitud y un diámetro.
• Parámetros requeridos:
  • long (string): -118.504744
  • lat (string): 34.01822
• Parámetros opcionales:
  • diameter (string): 2

cURL oficial (copiar/pegar):

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:

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

Notas para implementadores:

• Usa latitude y longitude para marcadores de mapa.
• Usa homeStatus y price para filtros y etiquetas.
• El objeto parameters devuelve la paginación y filtros predeterminados donde sea aplicable.

2) Buscar por Polígono

Utiliza esto cuando el usuario dibuja un límite en un mapa. Envías pares de coordenadas ordenadas para limitar el área de búsqueda.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• Descripción: Buscar propiedades en un área específica de polígono geográfico. Perfecto para aquellos que necesitan más control sobre sus límites de búsqueda, esta función permite encontrar propiedades en áreas geográficas complejas o no estándar. Soporta todos los filtros y opciones disponibles en Zillow.com.
• Parámetros requeridos:
  • polygon (string): -118.50394248962402 34.02926010734425, -118.5084056854248 34.02926010734425, -118.51286888122559 34.028691046671696, -118.51527214050293 34.02570341552858, -118.51321220397949 34.02257340341831, -118.51750373840332 34.0215774662657, -118.51681709289551 34.017878168811684, -118.51286888122559 34.016455319170184, -118.51080894470215 34.013324966013194, -118.50789070129395 34.010621386310234, -118.50411415100098 34.008629219864694, -118.49982261657715 34.008486920473, -118.49570274353027 34.007063913440916, -118.4919261932373 34.00891381793271, -118.48849296569824 34.01119056813859, -118.4860897064209 34.014463289606894, -118.48471641540527 34.018020452464164, -118.48042488098145 34.01858958468914, -118.4780216217041 34.0215774662657, -118.47939491271973 34.0249920592766, -118.47681999206543 34.02797971546417, -118.47493171691895 34.03125178964367, -118.4721851348877 34.034381481654364, -118.47733497619629 34.035377268536706, -118.48231315612793 34.035377268536706, -118.48677635192871 34.035377268536706, -118.49141120910645 34.03495050416125, -118.49604606628418 34.034096968969656, -118.49621772766113 34.03054047990366, -118.50033760070801 34.02926010734425, -118.50239753723145 34.032532132148006, -118.50394248962402 34.02926010734425

cURL oficial (copiar/pegar):

Ejemplo de respuesta:

Notas para implementadores:

• Envía el polígono como una lista separada por comas de pares “longitud latitud”.
• La API soporta filtros disponibles en Zillow.com. Usa la búsqueda por polígono para dibujar en el mapa y superposiciones de vecindario.

3) Buscar por Ubicación (ciudad, vecindario, ZIP)

Utiliza esto para una búsqueda estándar basada en lugar donde ya conoces una cadena de ubicación común.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• Descripción: Buscar propiedades por ubicación (condado, vecindario, ciudad o código postal).
• Parámetros requeridos:
  • location (string): Los Ángeles, CA
• Parámetros opcionales:
  • page (string): 2
  • home_status (string): FOR_SALE

cURL oficial (copiar/pegar):

JSON oficial (verbatim):

Conclusiones para desarrolladores:

• parameters.page muestra la página actual. Usa esto para implementar la paginación de “siguiente página”.
• Campos como imgSrc, detailUrl, y statusText te ayudan a renderizar tarjetas rápidamente.

Un ejemplo de código funcional (Python) para búsqueda por coordenadas

El siguiente ejemplo en Python llama a Buscar por Coordenadas y imprime una fila compacta para cada propiedad. Utiliza solo los parámetros y campos documentados del ejemplo anterior.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates"
params = {
"long": "-118.504744",
"lat": "34.01822",
"diameter": "2"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

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

print(f"Status: {payload.get('status')} Request ID: {payload.get('request_id')}")
p = payload.get("parameters", {})
print(f"Center: ({p.get('lat')}, {p.get('long')}) diameter={p.get('diameter')} page={p.get('page')}")

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
city = item.get("city")
state = item.get("state")
price = item.get("price")
beds = item.get("bedrooms")
baths = item.get("bathrooms")
lat = item.get("latitude")
lon = item.get("longitude")
status = item.get("homeStatus")
print(f"{zpid} | {status} | ${price} | {beds} bd / {baths} ba | {addr} | {city}, {state} | ({lat}, {lon})")

Qué adaptar:

• Vincula lat y long al centro de tu mapa cuando el usuario se desplace/acércate.
• Usa zpid como un identificador estable para deduplicación o enrutamiento de detalles.
• Devuelve parameters.page si agregas recuperación paginada; almacena en caché por centro y página para evitar llamadas extra.

Guía de campos para el JSON que realmente usarás

De los ejemplos oficiales anteriores, la mayoría de las aplicaciones conectan estos campos de inmediato:

• data[].latitude, data[].longitude: colocación de marcadores en tu proyección de mapa.
• data[].address, data[].city, data[].state, data[].zipcode: resúmenes de resultados de búsqueda y encabezados de detalle.
• data[].price y data[].currency: visualización de precios.
• data[].homeStatus (por ejemplo, FOR_SALE): filtrado y etiquetas.
• data[].bedrooms, data[].bathrooms, data[].livingArea: filtros y hechos de elementos de lista.
• data[].imgSrc y data[].detailUrl: imágenes principales y enlaces profundos externos de detalle (presentes en el ejemplo de búsqueda por ubicación).
• parameters.page: usa cuando agregues UX de paginación.

Notas de implementación que ahorran tiempo:

• Almacenamiento en caché: almacena en caché por la URL completa de la solicitud (incluida la cadena de consulta) para reducir llamadas repetidas cuando los usuarios se desplazan ligeramente pero permanecen dentro de la misma área.
• Paginación: la respuesta incluye un eco de parameters.page. Mantenlo en tu estado para “Cargar más”.
• UX de búsqueda geográfica: para búsquedas por coordenadas y polígono, vuelve a calcular las consultas solo después de eventos de inactividad o finalización de arrastre para evitar solicitudes excesivas.

Casos de uso prácticos de geolocalización que puedes implementar esta semana

• Función móvil de “Casas cerca de mí”: obtén la ubicación del dispositivo, consulta Buscar por Coordenadas, y coloca marcadores para listados visibles.
• Búsqueda dibujada en el mapa: permite a los usuarios esbozar límites personalizados y publicar los pares de coordenadas resultantes en Buscar por Polígono.
• Destacar vecindarios: predefine polígonos para vecindarios y consulta dentro de cada uno mientras el usuario navega por las pestañas.
• Navegar y refinar por ZIP: comienza con Buscar por Ubicación para una ciudad o ZIP, luego cambia a Buscar por Coordenadas a medida que los usuarios se desplazan/acercan.

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

Si utilizas clientes compatibles con MCP (Claude Code, Cursor, Windsurf, o cualquier cliente MCP), tu agente puede llamar a los mismos endpoints HTTPS a través de la puerta de enlace MCP de Zyla en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Esto permite que el agente invoque la API de Datos de Zillow en Tiempo Real con tu clave existente y transmita resultados de vuelta al IDE o tiempo de ejecución. Consulta MCP para detalles del adaptador.

Lista de verificación de integración

• Obtén tu clave de la lista de la API y guárdala de forma segura (por ejemplo, del lado del servidor o secretos gestionados en CI/CD).
• Elige tu modo de búsqueda:
  • Coordenadas para proximidad de centro + diámetro.
  • Polígono para límites dibujados por el usuario.
  • Ubicación para arranque de ciudad/ZIP/vecindario.
• Renderiza los campos esenciales:
  • Marcadores de mapa de latitude/longitude.
  • Tarjetas de address, price, bedrooms, bathrooms, livingArea, y URLs de imágenes cuando estén presentes.
• Implementa paginación utilizando el parámetro page y su eco en parameters.page si enumeras muchos resultados.
• Almacena en caché las consultas por URL completa; invalida cuando el centro del mapa o el polígono cambien.

Consejos de solución de problemas

• Fallos de autorización: asegúrate de que el encabezado sea exactamente Authorization: Bearer YOUR_API_KEY.
• Resultados vacíos: verifica tus valores de location, lat/long, o polygon y cualquier filtro opcional como home_status.
• Formato de polígono: envía una lista separada por comas de pares “longitud latitud” en orden; asegúrate de la codificación de URL para espacios/comas al construir la cadena de consulta.
• Latencia: difiere las solicitudes hasta el final del arrastre o debilita tu entrada para evitar inundar llamadas durante los desplazamientos del mapa.

Preguntas frecuentes

¿Cómo pagino los resultados?
Usa el parámetro de consulta page en los endpoints que lo aceptan (por ejemplo, Buscar por Ubicación) y lee parameters.page de la respuesta para rastrear tu página actual.

¿Qué campos debo almacenar como identificadores?
zpid es el identificador estable de la propiedad. Úsalo para deduplicar, marcadores y enrutamiento a pantallas de detalle.

¿Puedo filtrar por estados de listado específicos?
Donde sea compatible, pasa home_status (por ejemplo, FOR_SALE) exactamente como se muestra en los parámetros del endpoint y verifícalo en el eco de parameters de la respuesta.

¿Qué unidades se utilizan para precio y área?
La carga útil incluye price con currency (por ejemplo, USD) y puede incluir livingArea o campos de lote donde estén presentes. Renderiza los valores como se devuelven; no asumas conversiones.

¿Puedo llamar a esto desde un agente de IA?
Sí. Usa la puerta de enlace MCP en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY desde cualquier cliente compatible con MCP. Consulta la página MCP para más detalles.

Implementalo

Toma tu clave API y comienza a consultar propiedades por coordenadas, polígono o nombre de lugar. Crea tu cuenta y comienza tu prueba de 7 días en la API de Datos de Zillow en Tiempo Real aquí: Comienza prueba de 7 días en la API de Datos de Zillow en Tiempo Real. Con más de 10,000 APIs públicas en Zyla API Hub, puedes expandir tus características de geolocalización sin agregar más flujos de autenticación o sistemas de facturación.