Você precisa procurar propriedades por endereço ou desenhar um limite de mapa e obter listagens de volta—esta semana, não no próximo trimestre. Ao final deste guia, você consultará dados de propriedades geolocalizadas por cidade/CEP, por latitude/longitude precisas e por polígonos personalizados usando a API de Dados Zillow em Tempo Real no Zyla API Hub, com requisições copiáveis e um script Python mínimo.
O que você pode construir com uma API de propriedades com geolocalização em primeiro lugar
A API de Dados Zillow em Tempo Real fornece pesquisa de propriedades geolocalizadas que retorna atributos chave de listagem, incluindo endereço, cidade, estado, CEP, latitude, longitude, tipo de casa, preço (em USD), quartos, banheiros, área útil e mais. Você pode:
- Pesquisar propriedades por string de localização (cidade, condado, bairro ou código postal).
- Pesquisar pelo centro do mapa usando latitude/longitude e um diâmetro em milhas.
- Pesquisar dentro de um polígono personalizado—ideal para desenhar bairros ou corredores de entrega em um mapa.
Aplicações típicas incluem interfaces de busca de imóveis, mapas de “casas perto de mim”, análises de bairros, bots de alerta sobre novas listagens FOR_SALE e enriquecimento de endereço para geolocalização em ferramentas internas—tudo enraizado em Geolocalização.
Começando no Zyla API Hub
O Zyla API Hub hospeda mais de 10.000 APIs públicas em um único marketplace. Para usar a API de Dados Zillow em Tempo Real:
- Abra a página da API e inicie um teste de 7 dias: Iniciar teste de 7 dias na API de Dados Zillow em Tempo Real.
- Inscreva-se (assinatura + cota; não é pago por chamada). Primeira API: teste de 7 dias ou 50 requisições. Verifique a página da API para opções de acesso e preços atuais.
- Obtenha sua chave de API e envie requisições com o cabeçalho: Authorization: Bearer YOUR_API_KEY.
Endpoints: pesquisa com geolocalização
1) Pesquisa (por localização semelhante a endereço)
Use isso quando você tiver uma string de localização, como uma cidade, condado, bairro ou CEP.
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- Parâmetros obrigatórios: location (por exemplo, “Los Angeles, CA”)
- Parâmetros opcionais: page (por exemplo, “2”), home_status (por exemplo, “FOR_SALE”)
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"Exemplo de resposta (truncado para os campos de bloco de amostra oficiais):
{
"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á na maioria dos fluxos de geolocalização:
- address, city, state, zipcode: campos de localização prontos para exibição.
- latitude, longitude: pin em um mapa ou calcular distância para POIs.
- price e currency (USD): renderizar preço, classificar ou filtrar do lado do cliente.
- bedrooms, bathrooms, livingArea: resumos rápidos para cartões e filtros.
- detailUrl: link para a página de listagem quando necessário.
- page em parâmetros: use-o para paginar pelos resultados.
2) Pesquisa por Coordenadas (ponto + diâmetro)
Use isso quando você tiver um centro de mapa e quiser casas dentro de uma área de pesquisa circular.
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- Parâmetros obrigatórios: long, lat
- Parâmetros opcionais: diameter
cURL:
Exemplo de resposta (fatia de amostra oficial):
3) Pesquisa por Polígono (área desenhada personalizada)
Use isso para pesquisar dentro de formas complexas ou não padronizadas desenhadas em um mapa—ideal quando um simples raio não é preciso 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 (pares de lng lat separados por espaço, delimitados por vírgulas)
cURL:
Exemplo de resposta (fatia de amostra oficial):
Exemplo em Python: pesquisa de propriedades por endereço (dados de listagem geocodificados)
Este script mínimo chama o endpoint de Pesquisa com “Los Angeles, CA” e imprime campos chave de geolocalização e preços.
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("Status:", payload.get("status"))
print("Request ID:", payload.get("request_id"))
print("Params echoed by API:", payload.get("parameters"))
for item in payload.get("data", []):
print("---")
print("zpid:", item.get("zpid"))
print("address:", item.get("address"))
print("city/state/zip:", item.get("city"), item.get("state"), item.get("zipcode"))
print("lat/long:", item.get("latitude"), item.get("longitude"))
print("homeType:", item.get("homeType"))
print("price:", item.get("price"), item.get("currency"))
print("beds/baths/area:", item.get("bedrooms"), item.get("bathrooms"), item.get("livingArea"))
print("detailUrl:", item.get("detailUrl"))Notas práticas que economizam tempo
- Autenticação: envie Authorization: Bearer YOUR_API_KEY em cada requisição.
- Paginando: page é um parâmetro string. Incremente-o para paginar pelos resultados; a API ecoa o valor da página em parâmetros para rastreabilidade.
- Coordenadas: latitude/longitude são graus decimais; renderize diretamente em mapas da web. Distâncias para a pesquisa de coordenadas usam o parâmetro de diâmetro fornecido.
- Moeda: preço e moeda são retornados; exemplos mostram USD. Não assuma conversão—renderize os valores fornecidos.
- Filtragem: home_status suporta valores como FOR_SALE nestes exemplos. Aplique filtragem adicional do lado do cliente conforme necessário com base nos campos retornados.
- Cache: muitas consultas de localização são armazenáveis em cache atrás de uma chave de localização+página. Quebre o cache quando você mudar filtros como home_status ou quando a frescura importa.
- Imagens: imgSrc pode ser usado para miniaturas onde disponível.
Casos de uso com geolocalização que você pode enviar agora
- Widget de “Casas perto de mim”: chame a Pesquisa por Coordenadas com a geolocalização do usuário e um pequeno diâmetro para uma pesquisa de raio apertado.
- Páginas de destino baseadas em cidade ou CEP: chame a Pesquisa com localização definida para cidade ou CEP, pagine pelos resultados e pré-renderize cartões com endereço, preço e coordenadas.
- Pesquisa com limite desenhado: capture pontos de polígono de uma interface de desenho de mapa e chame a Pesquisa por Polígono para áreas de alta precisão.
- Mapas de ordenação por distância ou cluster: use latitude/longitude para calcular distâncias do lado do cliente e agrupar marcadores.
- Enriquecimento de detalhes de listagem: armazene zpid, endereço e lat/long para juntar com seus próprios conjuntos de dados para análises de bairro.
Chame esta API de agentes de IA via MCP
Se você usar clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf), você pode direcionar chamadas através do endpoint MCP da Zyla e manter seu gerenciamento de chaves centralizado. Veja o ponto de entrada MCP aqui: MCP. Configure seu agente para invocar os endpoints HTTPS da API de Dados Zillow em Tempo Real mostrados acima e passe seu cabeçalho de Autorização padrão. Isso é útil para fluxos de agentes como “desenhar um polígono, depois resumir as 10 principais listagens FOR_SALE dentro dele.”
Lista de verificação de solução de problemas
- Erros 401 ou 403: confirme se o cabeçalho de Autorização usa Bearer YOUR_API_KEY e se a assinatura está ativa.
- Sem resultados: verifique a formatação da localização ou as coordenadas do polígono (ordenação lng lat, pares separados por vírgulas, espaços entre lng e lat).
- Deslocamentos de mapa: certifique-se de que você está usando os campos de latitude e longitude em nível de item e não os centróides da cidade.
- Gaps de paginação: certifique-se de que você incrementa a página como uma string e para quando uma página retorna um array de dados vazio.
FAQ
A API retorna latitude e longitude para cada propriedade?
Sim. As listagens incluem campos de latitude e longitude adequados para mapeamento e cálculos de distância.
Como faço para pesquisar por uma localização de mapa precisa?
Use a Pesquisa por Coordenadas com long e lat (e opcionalmente diâmetro) para consultar propriedades próximas a um ponto.
Posso pesquisar dentro de uma forma personalizada desenhada por um usuário?
Sim. Use a Pesquisa por Polígono e passe uma string de polígono de pares de coordenadas lng lat, separados por vírgulas.
Como faço para paginar por um grande conjunto de resultados?
Passe a página como um parâmetro. A API ecoa a página em parâmetros para que você possa rastrear onde está.
Há um plano gratuito?
Não há Plano Gratuito. Você pode iniciar um teste de 7 dias (ou 50 requisições para sua primeira API). Verifique a página da API para opções de acesso e preços atuais.
Pronto para enviar a pesquisa de propriedades impulsionada por geolocalização? Inicie seu teste de 7 dias e obtenha sua chave de API aqui: Iniciar teste de 7 dias na API de Dados Zillow em Tempo Real. Em seguida, conecte os endpoints acima ao seu mapa, backend ou fluxo de agente e vá ao ar.
