Trabalhando com a API de Dados do Zillow em Tempo Real

Sua equipe precisa de um inventário imobiliário ao vivo que você possa filtrar por cidade, limites de mapa ou um polígono desenhado, e você precisa disso esta semana. Ao final deste guia, você será capaz de puxar listagens ao estilo Zillow em tempo real por localização, coordenadas ou um polígono personalizado usando a API de Dados do Zillow em Tempo Real no Zyla API Hub, analisar os campos que você se importa (preço, quartos, banheiros, zestimate, endereço, coordenadas) e integrá-lo ao seu aplicativo ou a um fluxo de trabalho de agente de IA.

O que você pode construir com a API de Dados do Zillow em Tempo Real

A API de Dados do Zillow em Tempo Real expõe pontos finais de pesquisa que retornam listagens de propriedades e metadados como zpid, endereço, coordenadas, tipo de casa, preço e moeda, Zestimate e rent Zestimate, valores avaliados, quartos, banheiros, área útil, dias no Zillow e mais. Você pode:

Ilustração: Trabalhando com a API de Dados do Zillow em Tempo Real

Pesquisar por uma localização legível por humanos como “Los Angeles, CA”.
Pesquisar dentro de um raio em torno de latitude/longitude.
Pesquisar dentro de um polígono arbitrário para corresponder a formas de bairros complexos ou áreas de serviço personalizadas.

Integrações típicas incluem aplicativos de busca de compradores/inquilinos, painéis de agentes com filtros geográficos, análises de propriedades e ferramentas de comparação instantânea.

Começando no Zyla API Hub

Abra a listagem da API de Dados do Zillow em Tempo Real no Zyla API Hub e inscreva-se para começar a fazer solicitações. O Zyla usa um modelo de assinatura + cota (não pago por chamada). Para esta API, você pode começar com um teste de 7 dias diretamente da página de listagem. Uma conta e uma chave de API funcionam em todo o catálogo de mais de 10.000 APIs públicas.

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

Após se inscrever, você receberá uma chave de API. Autentique cada solicitação com o cabeçalho: Authorization: Bearer YOUR_API_KEY.

Pontos finais que você usará

Abaixo estão os três pontos finais disponíveis. Cada um retorna JSON com um status, request_id, parâmetros de solicitação ecoados de volta e um array de dados de listagens. Use apenas os parâmetros mostrados para cada ponto final.

1) Pesquisa — por cidade, bairro, condado ou CEP

Use isso quando você tiver um nome de lugar legível por humanos. Ele suporta paginação opcional e filtragem por status da casa.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
Parâmetros de consulta obrigatórios:
- location (string): e.g., Los Angeles, CA
Parâmetros de consulta opcionais:
- page (string): número da página
- home_status (string): e.g., FOR_SALE

cURL (exemplo oficial):

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 (exemplo oficial):

{
"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ê usará mais:

zpid (string): identificador de propriedade estável.
detailUrl (string): link direto para visualizar a página da listagem.
preço, moeda, zestimate, rentZestimate (números e moeda): contexto de preços.
quartos, banheiros, livingArea, area (números): especificações da casa; area/livingArea estão em pés quadrados quando presentes.
latitude, longitude e latLong: mapeamento.
homeStatus/statusType/statusText: sinais de status da listagem (por exemplo, FOR_SALE).
daysOnZillow/timeOnZillow: frescor do mercado.

Exemplo em Python (requests):

import requests

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": "Bearer YOUR_API_KEY"}

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

print("Status:", payload.get("status"))
print("Request ID:", payload.get("request_id"))

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
price = item.get("price")
beds = item.get("bedrooms") or item.get("beds")
baths = item.get("bathrooms") or item.get("baths")
lat = item.get("latitude") or (item.get("latLong") or {}).get("latitude")
lng = item.get("longitude") or (item.get("latLong") or {}).get("longitude")
detail = item.get("detailUrl")
print(f"[{zpid}] {addr} | ${price} | {beds} bd / {baths} ba | ({lat}, {lng}) -> {detail}")

2) Pesquisa por Coordenadas — ponto central + diâmetro

Use isso para encontrar propriedades dentro de uma área circular em torno de uma latitude/longitude central. Útil para recursos de “perto de mim” ou proximidade a um local.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
Parâmetros de consulta obrigatórios:
- long (string): longitude
- lat (string): latitude
Parâmetros de consulta opcionais:
- diameter (string): diâmetro de pesquisa

cURL:

Exemplo JSON:

Notas:

As coordenadas estão em graus decimais. Certifique-se de codificar a URL dos parâmetros de consulta.
O payload de dados inclui os mesmos campos principais que o ponto final de Pesquisa.

3) Pesquisa por Polígono — limites de área personalizados

Use isso quando um círculo não for preciso o suficiente. Forneça um polígono como uma sequência de pares de coordenadas “long lat” separados por vírgulas. Isso é ideal para corresponder a bairros irregulares, zonas escolares ou territórios de serviço. O ponto final suporta todos os filtros e opções disponíveis no Zillow.com.

Método: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
Parâmetros de consulta obrigatórios:
- polygon (string): pares “longitude latitude” ordenados separados por vírgulas (veja o exemplo)

cURL:

Exemplo JSON:

Notas:

Formate cada vértice como “longitude latitude”. Separe os vértices com vírgulas.
Codifique a string do polígono na URL. O exemplo acima mostra a codificação adequada usando “+” para espaços e “%2C” para vírgulas dentro do valor do parâmetro.

Detalhes práticos de implementação

Autenticação: Sempre inclua Authorization: Bearer YOUR_API_KEY.
Paginando: Use o parâmetro page em Pesquisa e pontos finais suportados por paginação para buscar páginas de resultados subsequentes. A API ecoa a página que você solicitou no objeto de parâmetros.
Unidades e moeda:
- a moeda é tipicamente "USD". countryCurrency pode incluir o símbolo "$".
- valores de livingArea/area e lotAreaValue aparecem em pés quadrados quando lotAreaUnit é "sqft".
Filtragem: home_status pode ser definido como FOR_SALE (como mostrado). Filtros adicionais são suportados no Zillow.com; consulte a página da API para opções atuais.
Coordenadas: latitude/longitude estão em graus decimais.
Cache: Para feeds de listagens que mudam frequentemente (daysOnZillow, atualizações de preço), adicione cache de curta duração e atualização condicional em interações do usuário.
Links diretos: detailUrl pode abrir a página da listagem em uma visualização da web ou navegador externo.
Quotas: O acesso é por assinatura + cota. Verifique a página da API para opções de acesso e preços atuais.

Casos de uso do mundo real que você pode enviar rapidamente

Página de busca de compradores: Comece com Pesquisa por localização, depois mude para Pesquisa por Polígono quando os usuários desenharem em um mapa. Exiba preço, quartos, banheiros e vincule cada cartão a detailUrl.
CMA/comparações de agentes: Use Pesquisa por Coordenadas para coletar listagens dentro de um diâmetro de 1–2 milhas em torno de uma propriedade de referência; apresente zestimate e rentZestimate para um contexto de avaliação rápida.
Explorador de bairros: Pré-defina limites de polígono para cada bairro e consulte com Pesquisa por Polígono para garantir que os resultados respeitem as fronteiras locais e irregulares.
“Perto de mim” móvel: Com permissão de localização, chame Pesquisa por Coordenadas usando a posição GPS do usuário com um pequeno diâmetro para manter os resultados relevantes.

Chamando esta API de um agente de IA via MCP

Você também pode acionar esses pontos finais a partir de um cliente compatível com MCP. Aponte seu agente para o ponto final MCP do Zyla e use sua mesma chave de API:

MCP

Ponto final: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

Do seu cliente MCP, emita chamadas de ferramenta que realizam solicitações HTTPS GET para os mesmos URLs do hub mostrados acima.
Envie o cabeçalho Authorization: Bearer YOUR_API_KEY exatamente como nos exemplos de curl.
Mantenha as strings de consulta idênticas aos exemplos aqui para um comportamento estável em prompts e fluxos de agentes.

Solução de problemas e armadilhas

Erros 401 ou 403: Confirme se o cabeçalho Authorization está presente e se a chave de API é válida para sua assinatura.
Array de dados vazio: Verifique se seus filtros não estão muito restritivos; tente remover home_status ou ajustar o polígono/diâmetro.
Polígono malformado: Certifique-se de que cada ponto é “long lat”, não “lat long”, e que toda a string está codificada na URL.
Confusão de paginação: A API ecoa a página solicitada sob parameters.page. Incremente a página para percorrer conjuntos de resultados.
Codificando espaços e vírgulas: Em URLs, espaços devem ser codificados como + ou %20, e vírgulas como %2C dentro dos valores dos parâmetros de consulta.

FAQ

Como faço para autenticar solicitações?
Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.

Posso filtrar por status da listagem?
Sim. Defina home_status=FOR_SALE em pesquisas de Pesquisa e coordenadas/polígono onde suportado.

Como faço para pesquisar dentro de uma forma de bairro?
Use o ponto final Pesquisa por Polígono com uma lista ordenada de pares “longitude latitude” que traçam o limite do bairro, codificada na URL.

Quais unidades os valores de área usam?
Quando lotAreaUnit é "sqft", lotAreaValue é em pés quadrados. Os valores de livingArea/area também estão em pés quadrados quando presentes.

Onde posso ver opções de acesso e cotas?
Verifique a página da API no Zyla API Hub para opções de acesso e preços atuais. Assinaturas usam um modelo de cota, não pago por chamada.

Pronto para integrar a pesquisa de propriedades em tempo real em seu aplicativo? Comece seu teste de 7 dias e obtenha sua chave de API aqui: Comece o teste de 7 dias na API de Dados do Zillow em Tempo Real. Use uma conta e chave em todo o catálogo do Zyla API Hub e envie suas funcionalidades imobiliárias rapidamente.