Cómo buscar por coordenadas

Tienes una lat/long de un clic en el mapa o una lectura de GPS móvil, y necesitas obtener propiedades cercanas ahora mismo. Al final de esta guía, consultarás un verdadero endpoint de geolocalización con una coordenada central y un diámetro, analizarás la respuesta y la enviarás utilizando una única clave API de Zyla API Hub.

Lo que puedes construir con la búsqueda basada en coordenadas

La API de Datos en Tiempo Real de Zillow en Zyla API Hub devuelve datos de propiedades en vivo que puedes filtrar por geografía. Con ella puedes:

• Mostrar listados alrededor de la ubicación precisa de un usuario después de un toque en el mapa o un ping de GPS.
• Restringir características conscientes de la ubicación en tu aplicación inmobiliaria detrás de una API limpia.
• Limitar búsquedas a polígonos para límites de vecindario o formas personalizadas cuando sea necesario.

Esta API devuelve datos como zpid, dirección, latitud/longitud, tipo de casa, precio, estimaciones y más, adecuados para casos de uso de geolocalización como “¿qué hay en venta por aquí?”

Comenzando en Zyla API Hub

Abre la página de la API, suscríbete y obtén tu clave. Zyla utiliza una cuenta, una clave API y un modelo de suscripción + cuota en más de 10,000 APIs públicas. Para esta API, puedes comenzar una prueba de 7 días o hacer 50 solicitudes para validar tu integración antes de implementarla.

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

Harás llamadas a los endpoints con Authorization: Bearer YOUR_API_KEY y sin sorpresas de precios por llamada, solo usa tu cuota de suscripción. Puedes explorar más categorías en cualquier momento en Zyla API Hub.

Endpoints que usarás para geolocalización

Todas las solicitudes a continuación utilizan las URL de Zyla Hub y un token Bearer en el encabezado de autorización.

Buscar por Coordenadas

Busca propiedades alrededor de una lat/long central, opcionalmente restringiendo por diámetro.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• Parámetros requeridos:
  • long (string): longitud (por ejemplo, -118.504744)
  • lat (string): latitud (por ejemplo, 34.01822)
• Parámetros opcionales:
  • diametro (string): por ejemplo, 2

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 days on…

Lo que realmente usarás de la respuesta:

• data[].zpid: identificador de propiedad estable
• data[].latitude, data[].longitude: para trazar en el mapa
• data[].price y currency: precios para mostrar junto a los pines
• data[].address, city, state, zipcode: etiqueta y contexto
• data[].homeStatus/homeType: filtros rápidos en la interfaz de usuario
• parameters.long/lat/diameter: confirma cómo se interpretó la consulta

Buscar

Busca por etiqueta de ubicación (condado, vecindario, ciudad o código postal). Esto es útil cuando un usuario escribe “Los Ángeles, CA” o selecciona una ciudad de autocompletar.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• Parámetros requeridos:
  • location (string): por ejemplo, Los Ángeles, CA
• Parámetros opcionales:
  • page (string)
  • home_status (string): por ejemplo, FOR_SALE

Ejemplo oficial:

Usa esto cuando tu UX comienza desde un campo de texto de ubicación en lugar de un clic en el mapa. Aún obtienes los mismos campos de geolocalización (latitud/longitud) para trazar en un mapa.

Buscar por Polígono

Dibuja límites personalizados: campus, frentes de agua, distritos históricos, y busca dentro de ellos. Esto es ideal cuando la distancia radial no es suficiente.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• Parámetros requeridos:
  • polygon (string): una secuencia de pares “lon lat” separados por comas

Usa polígonos para anclar resultados a límites exactos que a tu equipo o usuarios les importan.

Ejemplo mínimo en Python: buscar por coordenadas

Este ejemplo llama al endpoint de coordenadas, verifica la respuesta y imprime las propiedades cercanas que puedes colocar en un mapa. Mantén la URL y los parámetros exactamente como se muestran.

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/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()

# Comprobaciones básicas de sanidad
if payload.get("status") != "OK":
raise RuntimeError(f"Estado inesperado: {payload}")

properties = payload.get("data", [])
for p in properties:
print({
"zpid": p.get("zpid"),
"status": p.get("homeStatus"),
"type": p.get("homeType"),
"price": p.get("price"),
"currency": p.get("currency"),
"lat": p.get("latitude"),
"lon": p.get("longitude"),
"address": p.get("address"),
"url": p.get("detailUrl")
})

# Ejemplo: centrar el mapa en el primer listado si está disponible
if properties:
first = properties[0]
center = (first.get("latitude"), first.get("longitude"))
print("Sugerencia de centro:", center)

Notas de implementación que te ahorran tiempo

• Encabezado de autenticación: Authorization: Bearer YOUR_API_KEY
• Entradas geográficas: pasa long, lat como cadenas; el diámetro es opcional.
• Moneda y unidades: la respuesta incluye moneda (por ejemplo, USD) y unidades de área (por ejemplo, sqft) donde sea aplicable. Usa los campos devueltos para mostrar en lugar de codificar en duro.
• Paginación: las respuestas incluyen un campo parameters.page que muestra la página seleccionada por el servidor. Cuando necesites páginas adicionales o filtrado, consulta la página de la API para las opciones actuales.
• Cacheo: si almacenas en caché los resultados, usa la tupla de consulta (long, lat, diameter) para evitar mezclar diferentes regiones.
• Manejo de errores: verifica que status == "OK" y maneja arreglos de datos vacíos de manera elegante; muestra request_id en los registros para acelerar el soporte.
• Cuota: esta API utiliza suscripción + cuota (no pago por llamada). La primera API que uses puede comenzar con una prueba de 7 días o 50 solicitudes para que puedas iterar rápidamente. Para las opciones de acceso y precios actuales, consulta la página de la API.

Cuándo usar cada modo de geolocalización

• Buscar por Coordenadas: mejor para “tocar en el mapa y mostrar lo que hay cerca.” Búsquedas rápidas y centradas que se mueven a medida que el usuario se desplaza.
• Buscar: ideal para ubicaciones escritas como “94110” o “Los Ángeles, CA.” Usa esto cuando aún no tengas coordenadas exactas.
• Buscar por Polígono: para precisión a nivel de vecindario. Restringe resultados a áreas personalizadas que tu producto define.

Llamando a la API desde agentes de IA a través de MCP

También puedes conectar estos endpoints a herramientas compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf). Dirige a tu cliente a la puerta de enlace MCP de Zyla y proporciona tu clave API; tu agente podrá invocar los mismos endpoints de listados de Hub que usaste arriba.

Documentos y endpoint: MCP

Usa la misma semántica de encabezado Authorization: Bearer YOUR_API_KEY en la configuración de la herramienta de tu agente donde sea aplicable. El beneficio es que mantienes una única clave a través de miles de APIs en Zyla API Hub mientras desarrollas en un flujo de trabajo impulsado por IA.

Flujo de extremo a extremo para implementar ahora

1. Comienza tu prueba en la página de la API y obtén tu clave.
2. Llama a Buscar por Coordenadas con long, lat y opcionalmente diámetro.
3. Renderiza data[].latitude/data[].longitude en tu mapa; muestra precio, dirección y detailUrl en una tarjeta.
4. Agrega un fallback: si el usuario escribe una ubicación, llama a Buscar.
5. Para límites personalizados, agrega un modo de dibujar polígono que llame a Buscar por Polígono.

FAQ

¿Cómo autentico las solicitudes?
Envía Authorization: Bearer YOUR_API_KEY con cada llamada a la URL del Hub.

¿Qué unidades de parámetro utiliza el diámetro?
El endpoint acepta un parámetro de diámetro como una cadena. Para la semántica de unidades específicas, consulta la página de la API para la documentación actual.

¿Puedo paginar búsquedas de coordenadas?
Las respuestas incluyen un campo parameters.page. Para soporte de paginación programática y parámetros de consulta disponibles, consulta la página de la API en Zyla.

¿Hay un plan gratuito?
El acceso utiliza suscripción + cuota, no pago por llamada. Puedes comenzar una prueba de 7 días o hacer 50 solicitudes para evaluar; consulta la página de la API para las opciones de acceso y precios actuales.

¿Puedo filtrar por estado de la casa?
El endpoint de Buscar acepta home_status como un parámetro opcional. Para endpoints geoespaciales, usa los parámetros documentados que se muestran arriba.

¿Listo para implementar la búsqueda de propiedades basada en coordenadas? Comienza tu prueba y obtén tu clave API aquí: Iniciar prueba de 7 días en la API de Datos en Tiempo Real de Zillow. Construye una vez con una única clave y escala a través del mercado de Zyla.