Você precisa de dados de propriedades no estilo Zillow frescos em seu aplicativo Python esta semana: pesquise por cidade, desenhe um polígono ao redor de um bairro ou consulte por lat/long para um mapa. Ao final deste guia, você chamará a API de Dados do Zillow em Tempo Real a partir do Python, paginará através das listagens e saberá como direcionar as mesmas chamadas através de um agente de IA usando o endpoint MCP da Zyla.
O que você pode construir com a API de Dados do Zillow em Tempo Real
A API de Dados do Zillow em Tempo Real no Zyla API Hub fornece resultados de busca de propriedades que você pode filtrar por:
- Strings de localização (cidade, condado, bairro ou código postal)
- Coordenadas (lat/long + um diâmetro)
- Polígonos personalizados (limites complexos que refletem suas ferramentas de desenho)
Cada resposta inclui campos nos quais os desenvolvedores confiam para alimentar alertas de compradores, painéis de inventário e interfaces de busca geodirigidas: zpid, endereço, coordenadas, preço, tipoDeCasa, quartos, banheiros, areaDeEstar, zestimate, rentZestimate e mais. Você consulta endpoints HTTPS diretos em Zyla API Hub com um único cabeçalho de Autorização e recebe JSON adequado para indexação ou exibição imediata.
Começando no Zyla API Hub
Abra a página da API de Dados do Zillow em Tempo Real e inicie um teste para obter sua chave:
- Vá para a listagem do marketplace: Iniciar teste de 7 dias na API de Dados do Zillow em Tempo Real
- Clique em Inscrever-se ou Iniciar Teste Gratuito (quando disponível).
- Pegue sua chave da API no painel da Zyla.
A autenticação é simples: passe Authorization: Bearer YOUR_API_KEY em cada solicitação. A Zyla usa um modelo de assinatura + cota (não é pago por chamada). A primeira API em sua conta normalmente oferece um teste de 7 dias ou 50 solicitações. Não há Plano Gratuito; verifique a página da API para opções de acesso e preços atuais.
Endpoints que você usará
Todos os endpoints são solicitações GET sob o domínio do Zyla API Hub. Use apenas os parâmetros documentados mostrados abaixo e inclua seu cabeçalho de Autorização. A paginação é tratada através do parâmetro page quando suportado pelo caminho específico.
1) Pesquisa (por string de localização)
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- Descrição: Pesquise propriedades por localização (condado, bairro, cidade ou código postal).
- Parâmetros de consulta obrigatórios:
- location (string): e.g., Los Angeles, CA
- Parâmetros de consulta opcionais:
- page (string): e.g., 2
- home_status (string): e.g., 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"JSON
{
"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…Campos principais que a maioria das equipes usa imediatamente: zpid (id único da listagem), preço (USD), quartos, banheiros, areaDeEstar (pés quadrados), latitude/longitude (para mapeamento), tipoDeCasa, zestimate, rentZestimate, daysOnZillow e detailUrl para deep-linking.
2) Pesquisa por Coordenadas
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- Descrição: Pesquise propriedades ao redor de um ponto de coordenada, opcionalmente delimitado por um diâmetro.
- Parâmetros de consulta obrigatórios:
- long (string): e.g., -118.504744
- lat (string): e.g., 34.01822
- Parâmetros de consulta opcionais:
- diameter (string): e.g., 2
cURL
O formato da resposta inclui um bloco de parâmetros ecoando sua consulta (long, lat, diameter, page, home_status, sort, listing_type) e um array de dados com listagens ao redor da coordenada. Este caminho é ideal para “pesquisar perto de mim”, consultas de pinos de mapa ou captura de leads baseada em rotas.
3) Pesquisa por Polígono
- Método: GET
- URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- Descrição: Pesquise propriedades dentro de um polígono personalizado. Este caminho suporta todos os filtros e opções disponíveis no Zillow.com, enquanto suas solicitações são definidas por uma string de polígono de pares de coordenadas.
- Parâmetros de consulta obrigatórios:
- polygon (string): pares de coordenadas separados por vírgulas (use a formatação exata do exemplo abaixo).
cURL
Use isso quando seus usuários desenham um limite em um mapa ou quando você precisa corresponder zonas escolares ou contornos de bairros definidos por investidores. A resposta inclui os parâmetros que você enviou, além de um array de dados de propriedades contidas dentro desse polígono.
Integração Python: exemplo de ponta a ponta
Abaixo está um script Python mínimo, copiável e colável, usando requests para acessar o endpoint de Pesquisa. Ele lê alguns campos do primeiro resultado e demonstra paginação básica. Mantenha seu cabeçalho de Autorização e parâmetros de URL exatamente como mostrado.
Python
import os
import sys
import time
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search"
def search_properties(location, page=None, home_status=None):
params = {"location": location}
if page is not None:
params["page"] = str(page)
if home_status is not None:
params["home_status"] = home_status
resp = requests.get(
BASE_URL,
headers={"Authorization": f"Bearer {API_KEY}"},
params=params,
timeout=30,
)
resp.raise_for_status()
return resp.json()
def main():
# Parâmetro obrigatório: location. Opcionais: page, home_status.
data = search_properties("Los Angeles, CA", page=2, home_status="FOR_SALE")
# Verificação rápida de sanidade
if data.get("status") != "OK":
print("Status não OK:", data)
sys.exit(1)
# Leia campos comuns da primeira listagem (se presente)
listings = data.get("data") or []
if not listings:
print("Nenhum resultado encontrado nesta página.")
sys.exit(0)
first = listings[0]
zpid = first.get("zpid")
price = first.get("price")
beds = first.get("bedrooms") or first.get("beds")
baths = first.get("bathrooms") or first.get("baths")
lat = first.get("latitude") or (first.get("latLong") or {}).get("latitude")
lng = first.get("longitude") or (first.get("latLong") or {}).get("longitude")
detail_url = first.get("detailUrl")
print("Primeiro resultado:")
print(" zpid:", zpid)
print(" preço (USD):", price)
print(" quartos/banheiros:", beds, "/", baths)
print(" coords:", lat, ",", lng)
print(" detalhes:", detail_url)
# Paginação: solicite a próxima página apenas se precisar
next_page = (data.get("parameters") or {}).get("page", 1)
try:
next_page = int(next_page) + 1
except Exception:
next_page = None
if next_page:
time.sleep(0.5) # seja educado entre as solicitações
more = search_properties("Los Angeles, CA", page=next_page, home_status="FOR_SALE")
print("Status da próxima página:", more.get("status"), "resultados:", len(more.get("data") or []))
if __name__ == "__main__":
main()Notas de design que economizam tempo
- Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY. Nenhuma autenticação de parâmetro de consulta é necessária.
- Moeda e unidades: Preço e zestimate estão em USD. areaDeEstar e area estão em pés quadrados, e lotAreaUnit pode retornar sqft.
- Paginação: Onde a página é suportada, é um parâmetro de string. Comece a partir da página 1 (padrão) e incremente até que o array de dados esteja vazio. Não assuma total_pages a menos que você o calcule você mesmo a partir dos resultados página a página.
- Cache: Para resultados de lista que apoiam uma interface de usuário, considere armazenar em cache pela sua string de consulta (por exemplo, localização + página + home_status) por um curto TTL para reduzir chamadas repetidas idênticas.
- Mapeamento: Use latitude e longitude em cada item; quando presente, latLong contém os mesmos dados como um objeto aninhado.
- Filtragem: Para Pesquisa por Polígono, as notas de listagem suportam todos os filtros e opções disponíveis no Zillow.com. Envie apenas parâmetros explicitamente documentados pela listagem. Quando você precisar de mais filtros, verifique a página da API para atualizações.
Casos de uso práticos
- Alertas de compradores: Consulte a Pesquisa ou Pesquisa por Coordenadas à noite para “FOR_SALE” e notifique os usuários sobre novos valores de zpid não vistos em sua última captura.
- Pesquisa no mapa: Use Pesquisa por Coordenadas para “perto de mim” e Pesquisa por Polígono quando os usuários desenham formas personalizadas ao redor de um limite de bairro.
- Escaneamentos de investidores: Combine consultas de polígono com paginação regular para exportar preço, quartos, banheiros, areaDeEstar, zestimate e rentZestimate para modelagem de taxa de capital.
- Roteamento de leads: Leia cidade, código postal e preço para atribuir novas listagens aos agentes certos em seu CRM.
Chamando a API através de um agente de IA (MCP)
Se você usar um IDE ou agente de IA centrado em código (Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP), você pode direcionar chamadas para esta API através do endpoint MCP da Zyla. Configure seu agente com o endereço MCP da Zyla e sua chave. O agente pode então invocar os mesmos caminhos HTTPS que você viu acima através da camada MCP.
- Endpoint MCP: MCP
- Forneça sua chave da API Zyla ao cliente MCP quando solicitado.
- Peça ao agente para acessar o caminho relevante da API de Dados do Zillow em Tempo Real, especificando os mesmos parâmetros de string de consulta (por exemplo, localização ou polígono) que você usaria diretamente.
Isso permite que você crie integrações, escreva scrapers ou teste variações de consulta de forma conversacional sem sair do seu editor.
Recapitulação dos endpoints com parâmetros
- Pesquisa
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- Obrigatório: location
- Opcional: page, home_status
- Pesquisa por Coordenadas
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- Obrigatório: long, lat
- Opcional: diameter
- Pesquisa por Polígono
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- Obrigatório: polygon
Todas as solicitações requerem o cabeçalho de Autorização com sua chave da API Zyla. Visite a página da API de Dados do Zillow em Tempo Real em Zyla API Hub para revisar detalhes adicionais e atualizações.
Colocando tudo junto rapidamente
Para um MVP de produção, faça o seguinte:
- Crie uma chave na página de listagem da API e armazene-a como ZYLA_API_KEY em seu env.
- Conecte o caminho de Pesquisa para aceitar entrada do usuário para localização e paginação. Retorne zpid, preço, quartos, banheiros, areaDeEstar e detailUrl para seu frontend.
- Na sua página de mapa, mude para Pesquisa por Coordenadas para suportar descoberta baseada em pinos; debounce as solicitações enquanto o usuário navega.
- Adicione um modo de pesquisa avançada com Pesquisa por Polígono para permitir que os usuários desenhem áreas personalizadas.
- Armazene em cache por URL e página para reduzir buscas duplicadas; atualize periodicamente.
FAQ
Qual autenticação a API de Dados do Zillow em Tempo Real usa?
Envie Authorization: Bearer YOUR_API_KEY em cada solicitação. Não coloque a chave na string de consulta.
Como faço para paginar resultados?
Use o parâmetro de consulta page onde suportado (por exemplo, o endpoint de Pesquisa). Incremente a página enquanto os resultados continuarem retornando itens de dados.
Posso pesquisar dentro de uma forma desenhada?
Sim. Use o caminho Pesquisa por Polígono e passe o parâmetro de consulta polygon exatamente como uma sequência de pares de coordenadas (formato mostrado no exemplo cURL).
Quais unidades e moeda são usadas?
Os preços e zestimate estão em USD. areaDeEstar e area estão em pés quadrados; lotAreaUnit também pode retornar sqft.
Há um plano gratuito?
Não há Plano Gratuito. A Zyla usa assinatura + cota. A primeira API normalmente inclui um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Pronto para enviar? Inicie seu teste, obtenha uma chave e execute o cURL acima contra a API de Dados do Zillow em Tempo Real. Seu próximo passo: abra o item do marketplace e inscreva-se aqui: Iniciar teste de 7 dias na API de Dados do Zillow em Tempo Real.
