Como pesquisar por coordenadas

Você tem uma lat/long de um clique no mapa ou uma leitura de GPS móvel, e precisa buscar propriedades próximas agora mesmo. Ao final deste guia, você fará uma consulta a um endpoint de geolocalização real com uma coordenada central e diâmetro, analisará a resposta e a enviará usando uma única chave de API do Zyla API Hub.

O que você pode construir com pesquisa baseada em coordenadas

A API de Dados em Tempo Real do Zillow no Zyla API Hub retorna dados de propriedades ao vivo que você pode filtrar por geografia. Com ela, você pode:

• Mostrar listagens ao redor da localização precisa de um usuário após um toque no mapa ou um ping de GPS.
• Controlar recursos cientes da localização em seu aplicativo imobiliário por trás de uma API limpa.
• Restringir pesquisas a polígonos para limites de bairros ou formas personalizadas quando necessário.

Esta API retorna dados como zpid, endereço, latitude/longitude, tipo de casa, preço, estimativas e mais—adequados para casos de uso de geolocalização como “o que está à venda por aqui?”

Começando no Zyla API Hub

Abra a página da API, inscreva-se e obtenha sua chave. O Zyla usa uma conta, uma chave de API e um modelo de assinatura + cota em mais de 10.000 APIs públicas. Para esta API, você pode iniciar um teste de 7 dias ou fazer 50 solicitações para validar sua integração antes de enviar.

Iniciar teste de 7 dias na API de Dados em Tempo Real do Zillow

Você chamará endpoints com Authorization: Bearer YOUR_API_KEY e sem surpresas de preços por chamada—basta usar sua cota de assinatura. Você pode navegar por mais categorias a qualquer momento em Zyla API Hub.

Endpoints que você usará para geolocalização

Todas as solicitações abaixo usam as URLs do Zyla Hub e um token Bearer no cabeçalho de Autorização.

Pesquisar por Coordenadas

Pesquise propriedades ao redor de uma lat/long central, opcionalmente restringindo por diâmetro.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• Parâmetros obrigatórios:
  • long (string): longitude (ex: -118.504744)
  • lat (string): latitude (ex: 34.01822)
• Parâmetros opcionais:
  • diameter (string): ex: 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"

Exemplo de resposta:

{
"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 à venda",
"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 dias em…

O que você realmente usará da resposta:

• data[].zpid: identificador de propriedade estável
• data[].latitude, data[].longitude: para plotagem no mapa
• data[].price e currency: preços a serem exibidos ao lado dos marcadores
• data[].address, city, state, zipcode: rótulo e contexto
• data[].homeStatus/homeType: filtros rápidos na UI
• parameters.long/lat/diameter: confirma como a consulta foi interpretada

Pesquisar

Pesquise por rótulo de localização (condado, bairro, cidade ou código postal). Isso é útil quando um usuário digita “Los Angeles, CA” ou seleciona uma cidade na autocompletação.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• Parâmetros obrigatórios:
  • location (string): ex: Los Angeles, CA
• Parâmetros opcionais:
  • page (string)
  • home_status (string): ex: FOR_SALE

Exemplo oficial:

Use isso quando sua UX começa a partir de uma entrada de texto de localização em vez de um clique no mapa. Você ainda obtém os mesmos campos de geolocalização (latitude/longitude) para plotar em um mapa.

Pesquisar por Polígono

Desenhe limites personalizados—campus, orlas, distritos históricos—e pesquise dentro deles. Isso é ideal quando a distância radial não é suficiente.

• Método: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• Parâmetros obrigatórios:
  • polygon (string): uma sequência de pares “lon lat” separados por vírgulas

Use polígonos para ancorar resultados a limites exatos que sua equipe ou usuários se importam.

Exemplo mínimo em Python: pesquisar por coordenadas

Este exemplo chama o endpoint de coordenadas, verifica a resposta e imprime as propriedades próximas que você pode colocar em um mapa. Mantenha a URL e os parâmetros exatamente como mostrado.

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

# Verificações básicas de sanidade
if payload.get("status") != "OK":
raise RuntimeError(f"Status 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")
})

# Exemplo: centralizar o mapa na primeira listagem, se disponível
if properties:
first = properties[0]
center = (first.get("latitude"), first.get("longitude"))
print("Sugestão de centro:", center)

Notas de implementação que economizam seu tempo

• Cabeçalho de autenticação: Authorization: Bearer YOUR_API_KEY
• Entradas geográficas: passe long, lat como strings; diâmetro é opcional.
• Moeda e unidades: a resposta inclui moeda (ex: USD) e unidades de área (ex: sqft) onde aplicável. Use os campos retornados para exibição em vez de codificar.
• Paginacao: as respostas incluem um campo parameters.page mostrando a página selecionada pelo servidor. Quando você precisar de páginas adicionais ou filtragem, consulte a página da API para opções atuais.
• Cache: se você armazenar resultados em cache, use a tupla de consulta (long, lat, diameter) para evitar misturar diferentes regiões.
• Tratamento de erros: verifique status == "OK" e trate arrays de dados vazios de forma elegante; exiba request_id nos logs para acelerar o suporte.
• Cota: esta API usa assinatura + cota (não pagamento por chamada). A primeira API que você usa pode começar com um teste de 7 dias ou 50 solicitações para que você possa iterar rapidamente. Para opções de acesso e preços atuais, consulte a página da API.

Quando usar cada modo de geolocalização

• Pesquisar por Coordenadas: melhor para “toque no mapa e mostre o que está próximo.” Pesquisas rápidas e centralizadas que se movem conforme o usuário navega.
• Pesquisar: ideal para locais digitados como “94110” ou “Los Angeles, CA.” Use isso quando você ainda não tiver coordenadas exatas.
• Pesquisar por Polígono: para precisão de nível de bairro. Restringir resultados a áreas personalizadas que seu produto define.

Chamando a API de agentes de IA via MCP

Você também pode conectar esses endpoints a ferramentas compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf). Aponte seu cliente para o gateway MCP do Zyla e forneça sua chave de API; seu agente pode então invocar os mesmos endpoints de listagem do Hub que você usou acima.

Docs e endpoint: MCP

Use a mesma semântica de cabeçalho Authorization: Bearer YOUR_API_KEY na configuração da ferramenta do seu agente, quando aplicável. O benefício é que você mantém uma única chave em milhares de APIs no Zyla API Hub enquanto desenvolve em um fluxo de trabalho orientado por IA.

Fluxo de ponta a ponta para implementar agora

1. Inicie seu teste na página da API e obtenha sua chave.
2. Chame Pesquisar por Coordenadas com long, lat e opcionalmente diâmetro.
3. Renderize data[].latitude/data[].longitude em seu mapa; mostre preço, endereço e detailUrl em um cartão.
4. Adicione uma alternativa: se o usuário digitar uma localização, chame Pesquisar.
5. Para limites personalizados, adicione um modo de desenhar polígono que chame Pesquisar por Polígono.

FAQ

Como faço para autenticar solicitações?
Envie Authorization: Bearer YOUR_API_KEY com cada chamada para a URL do Hub.

Quais unidades de parâmetro o diâmetro usa?
O endpoint aceita um parâmetro de diâmetro como uma string. Para semântica de unidade específica, consulte a página da API para a documentação atual.

Posso paginar pesquisas de coordenadas?
As respostas incluem um campo parameters.page. Para suporte de paginação programática e parâmetros de consulta disponíveis, consulte a página da API no Zyla.

Há um plano gratuito?
O acesso usa assinatura + cota, não pagamento por chamada. Você pode iniciar um teste de 7 dias ou fazer 50 solicitações para avaliar; consulte a página da API para opções de acesso e preços atuais.

Posso filtrar por status da casa?
O endpoint de Pesquisa aceita home_status como um parâmetro opcional. Para endpoints geoespaciais, use os parâmetros documentados mostrados acima.

Pronto para enviar a pesquisa de propriedades baseada em coordenadas? Inicie seu teste e obtenha sua chave de API aqui: Iniciar teste de 7 dias na API de Dados em Tempo Real do Zillow. Construa uma vez com uma única chave e escale pelo mercado Zyla.