Python रियल-टाइम Zillow डेटा API एकीकरण गाइड Zyla API हब के साथ

आपको इस सप्ताह अपने Python ऐप में ताजा Zillow-शैली का संपत्ति डेटा चाहिए: शहर द्वारा खोजें, एक पड़ोस के चारों ओर एक बहुभुज खींचें, या मानचित्र के लिए lat/long द्वारा क्वेरी करें। इस गाइड के अंत तक, आप Python से रियल-टाइम Zillow डेटा API को कॉल करेंगे, लिस्टिंग के माध्यम से पृष्ठांकन करेंगे, और जानेंगे कि Zyla के MCP एंडपॉइंट का उपयोग करके समान कॉल को एक AI एजेंट के माध्यम से कैसे पाइप करें।

आप रियल-टाइम Zillow डेटा API के साथ क्या बना सकते हैं

Zyla API हब पर रियल-टाइम Zillow डेटा API संपत्ति खोज परिणाम प्रदान करता है जिन्हें आप फ़िल्टर कर सकते हैं:

Illustration: Python Real-Time Zillow Data API Integration Guide with Zyla API Hub

स्थान स्ट्रिंग (शहर, काउंटी, पड़ोस, या ज़िप कोड)
निर्देशांक (lat/long + व्यास)
कस्टम बहुभुज (जटिल सीमाएँ जो आपके ड्राइंग टूल्स को दर्शाती हैं)

प्रत्येक प्रतिक्रिया में फ़ील्ड शामिल होते हैं जिन पर डेवलपर्स खरीदार अलर्ट, इन्वेंटरी डैशबोर्ड और भू-आधारित खोज UI को शक्ति देने के लिए भरोसा करते हैं: zpid, पता, निर्देशांक, मूल्य, homeType, बेडरूम, बाथरूम, livingArea, zestimate, rentZestimate, और अधिक। आप Zyla API Hub पर एकल प्राधिकरण हेडर के साथ सीधे HTTPS एंडपॉइंट पर क्वेरी करते हैं और तात्कालिक अनुक्रमण या प्रदर्शन के लिए उपयुक्त JSON प्राप्त करते हैं।

Zyla API हब पर शुरुआत करना

रियल-टाइम Zillow डेटा API पृष्ठ खोलें और अपनी कुंजी प्राप्त करने के लिए एक परीक्षण शुरू करें:

मार्केटप्लेस लिस्टिंग पर जाएं: रियल-टाइम Zillow डेटा API पर 7-दिन का परीक्षण शुरू करें
सब्सक्राइब या फ्री ट्रायल शुरू करें (जब उपलब्ध हो)।
Zyla डैशबोर्ड से अपनी API कुंजी प्राप्त करें।

प्रमाणीकरण सरल है: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY पास करें। Zyla एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (प्रति कॉल भुगतान नहीं)। आपके खाते में पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

आप जिन एंडपॉइंट्स का उपयोग करेंगे

सभी एंडपॉइंट्स Zyla API हब डोमेन के तहत GET अनुरोध हैं। केवल नीचे दिखाए गए प्रलेखित पैरामीटर का उपयोग करें, और अपने प्राधिकरण हेडर को शामिल करें। पृष्ठांकन विशेष पथ द्वारा समर्थित होने पर page पैरामीटर के माध्यम से संभाला जाता है।

1) स्थान स्ट्रिंग द्वारा खोजें

विधि: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
विवरण: स्थान (काउंटी, पड़ोस, शहर, या ज़िप कोड) द्वारा संपत्तियों की खोज करें।
आवश्यक क्वेरी पैरामीटर:
- स्थान (स्ट्रिंग): जैसे, लॉस एंजेलेस, CA
वैकल्पिक क्वेरी पैरामीटर:
- पृष्ठ (स्ट्रिंग): जैसे, 2
- home_status (स्ट्रिंग): जैसे, 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": "Home for sale",
"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…

अधिकांश टीमें तुरंत उपयोग करने वाले प्रमुख फ़ील्ड: zpid (विशिष्ट लिस्टिंग आईडी), मूल्य (USD), बेडरूम, बाथरूम, livingArea (वर्ग फुट), latitude/longitude (नक्शे के लिए), homeType, zestimate, rentZestimate, daysOnZillow, और गहरे लिंकिंग के लिए detailUrl।

2) निर्देशांक द्वारा खोजें

विधि: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
विवरण: एक निर्देशांक बिंदु के चारों ओर संपत्तियों की खोज करें, वैकल्पिक रूप से व्यास द्वारा स्कोप किया गया।
आवश्यक क्वेरी पैरामीटर:
- long (स्ट्रिंग): जैसे, -118.504744
- lat (स्ट्रिंग): जैसे, 34.01822
वैकल्पिक क्वेरी पैरामीटर:
- व्यास (स्ट्रिंग): जैसे, 2

cURL

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates?long=-118.504744&lat=34.01822&diameter=2" \
-H "Authorization: Bearer YOUR_API_KEY"

प्रतिक्रिया आकार में एक पैरामीटर ब्लॉक शामिल है जो आपकी क्वेरी (long, lat, diameter, page, home_status, sort, listing_type) को प्रतिध्वनित करता है और निर्देशांक के चारों ओर लिस्टिंग के साथ एक डेटा सरणी। यह पथ "मेरे पास खोजें," मानचित्र पिन क्वेरी, या रूटिंग-आधारित लीड कैप्चर के लिए आदर्श है।

3) बहुभुज द्वारा खोजें

विधि: GET
URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
विवरण: एक कस्टम बहुभुज के भीतर संपत्तियों की खोज करें। यह पथ Zillow.com पर उपलब्ध सभी फ़िल्टर और विकल्पों का समर्थन करता है, जबकि आपके अनुरोधों को निर्देशांक जोड़ों के एक बहुभुज स्ट्रिंग द्वारा परिभाषित किया जाता है।
आवश्यक क्वेरी पैरामीटर:
- polygon (स्ट्रिंग): कोऑर्डिनेट जोड़े जो अल्पविराम द्वारा अलग किए जाते हैं (नीचे दिए गए नमूने से सटीक प्रारूपण का उपयोग करें)।

cURL

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon?polygon=34.235462,-118.661224,34.235462,-118.661224" \
-H "Authorization: Bearer YOUR_API_KEY"

जब आपके उपयोगकर्ता मानचित्र पर एक सीमा खींचते हैं या जब आपको स्कूल क्षेत्रों या निवेशक-परिभाषित पड़ोस रूपरेखाओं से मेल खाने की आवश्यकता होती है तो इसका उपयोग करें। प्रतिक्रिया में वे पैरामीटर शामिल होते हैं जो आपने भेजे थे और उस बहुभुज के भीतर शामिल संपत्तियों की डेटा सरणी होती है।

Python एकीकरण: अंत-से-अंत उदाहरण

नीचे एक न्यूनतम, कॉपी-पेस्ट करने योग्य Python स्क्रिप्ट है जो खोज एंडपॉइंट को हिट करने के लिए अनुरोधों का उपयोग करती है। यह पहले परिणाम से कुछ फ़ील्ड पढ़ती है और बुनियादी पृष्ठांकन का प्रदर्शन करती है। अपने प्राधिकरण हेडर और URL पैरामीटर को ठीक उसी तरह रखें जैसा दिखाया गया है।

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():
# Required param: location. Optional: page, home_status.
data = search_properties("Los Angeles, CA", page=2, home_status="FOR_SALE")

# Quick sanity check
if data.get("status") != "OK":
print("Non-OK status:", data)
sys.exit(1)

# Read common fields from the first listing (if present)
listings = data.get("data") or []
if not listings:
print("No results found on this page.")
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("First result:")
print(" zpid:", zpid)
print(" price (USD):", price)
print(" beds/baths:", beds, "/", baths)
print(" coords:", lat, ",", lng)
print(" details:", detail_url)

# Pagination: request the next page only if you need it
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) # be polite between requests
more = search_properties("Los Angeles, CA", page=next_page, home_status="FOR_SALE")
print("Next page status:", more.get("status"), "results:", len(more.get("data") or []))

if __name__ == "__main__":
main()

डिज़ाइन नोट्स जो समय बचाते हैं

प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। कोई क्वेरी पैरामीटर प्रमाणीकरण आवश्यक नहीं है।
मुद्रा और इकाइयाँ: मूल्य और zestimate USD में हैं। livingArea और area वर्ग फुट में हैं, और lotAreaUnit sqft भी लौट सकता है।
पृष्ठांकन: जहां पृष्ठ समर्थित है, यह एक स्ट्रिंग पैरामीटर है। पृष्ठ 1 (डिफ़ॉल्ट) से शुरू करें और तब तक बढ़ाएं जब तक डेटा सरणी खाली न हो जाए। कुल_pages का अनुमान न लगाएं जब तक कि आप इसे स्वयं पृष्ठ-दर-पृष्ठ परिणामों से न निकालें।
कैशिंग: UI का समर्थन करने वाले सूची परिणामों के लिए, अपने क्वेरी स्ट्रिंग (जैसे, स्थान + पृष्ठ + home_status) द्वारा एक छोटे TTL के लिए कैशिंग पर विचार करें ताकि समान दोहराए गए कॉल को कम किया जा सके।
नक्शा: प्रत्येक आइटम पर latitude और longitude का उपयोग करें; जब मौजूद हो, latLong में एक नेस्टेड ऑब्जेक्ट के रूप में समान डेटा होता है।
फ़िल्टरिंग: बहुभुज द्वारा खोज के लिए, लिस्टिंग नोट्स Zillow.com पर उपलब्ध सभी फ़िल्टर और विकल्पों का समर्थन करते हैं। केवल उन पैरामीटर को भेजें जो स्पष्ट रूप से लिस्टिंग द्वारा प्रलेखित हैं। जब आपको अधिक फ़िल्टर की आवश्यकता हो, तो अपडेट के लिए API पृष्ठ की जांच करें।

व्यावहारिक उपयोग के मामले

खरीदार अलर्ट: रात में "FOR_SALE" के लिए खोज या निर्देशांक द्वारा खोज करें और उपयोगकर्ताओं को आपके पिछले स्नैपशॉट में नहीं देखे गए नए zpid मानों के बारे में सूचित करें।
मानचित्र खोज: "मेरे पास" के लिए निर्देशांक द्वारा खोज का उपयोग करें और जब उपयोगकर्ता पड़ोस की सीमा के चारों ओर कस्टम आकार खींचते हैं तो बहुभुज द्वारा खोज का उपयोग करें।
निवेशक स्कैन: बहुभुज क्वेरी को नियमित पृष्ठांकन के साथ मिलाएं ताकि मूल्य, बेडरूम, बाथरूम, livingArea, zestimate, और rentZestimate को कैप-रेट मॉडलिंग के लिए निर्यात किया जा सके।
लीड रूटिंग: नए लिस्टिंग को आपके CRM में सही एजेंटों को असाइन करने के लिए शहर, ज़िपकोड, और मूल्य पढ़ें।

AI एजेंट (MCP) के माध्यम से API को कॉल करना

यदि आप एक कोड-केंद्रित AI IDE या एजेंट (Claude Code, Cursor, Windsurf, या कोई भी MCP-संगत क्लाइंट) का उपयोग करते हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से इस API को कॉल कर सकते हैं। अपने एजेंट को Zyla MCP पते और अपनी कुंजी के साथ कॉन्फ़िगर करें। एजेंट तब MCP परत के माध्यम से आप ऊपर देखे गए समान HTTPS पथों को सक्रिय कर सकता है।

MCP एंडपॉइंट: MCP
प्रॉम्प्ट पर MCP क्लाइंट को अपनी Zyla API कुंजी प्रदान करें।
एजेंट से संबंधित रियल-टाइम Zillow डेटा API पथ को हिट करने के लिए कहें, वही क्वेरी स्ट्रिंग पैरामीटर निर्दिष्ट करें (जैसे, स्थान या बहुभुज) जो आप सीधे उपयोग करेंगे।

यह आपको एकीकरण को स्कैफोल्ड करने, स्क्रैपर्स लिखने, या अपने संपादक को छोड़े बिना बातचीत में क्वेरी भिन्नताओं का परीक्षण करने की अनुमति देता है।

पैरामीटर के साथ एंडपॉइंट पुनर्कथन

खोज
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- आवश्यक: स्थान
- वैकल्पिक: पृष्ठ, home_status
निर्देशांक द्वारा खोजें
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- आवश्यक: long, lat
- वैकल्पिक: व्यास
बहुभुज द्वारा खोजें
- GET https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- आवश्यक: बहुभुज

सभी अनुरोधों के लिए आपके Zyla API कुंजी के साथ प्राधिकरण हेडर की आवश्यकता होती है। अतिरिक्त विवरण और अपडेट की समीक्षा करने के लिए Zyla API Hub पर रियल-टाइम Zillow डेटा API पृष्ठ पर जाएं।

जल्दी सब कुछ एक साथ रखना

एक उत्पादन MVP के लिए, निम्नलिखित करें:

API लिस्टिंग पृष्ठ पर एक कुंजी बनाएं और इसे अपने env में ZYLA_API_KEY के रूप में स्टोर करें।
स्थान और पृष्ठांकन के लिए उपयोगकर्ता इनपुट स्वीकार करने के लिए खोज पथ को वायर करें। अपने फ्रंटएंड पर zpid, मूल्य, बेडरूम, बाथरूम, livingArea, और detailUrl लौटाएं।
अपने मानचित्र पृष्ठ पर, पिन-आधारित खोज का समर्थन करने के लिए निर्देशांक द्वारा खोज पर स्विच करें; जैसे-जैसे उपयोगकर्ता पैन करते हैं, अनुरोधों को डिबाउंस करें।
उपयोगकर्ताओं को कस्टम क्षेत्रों को खींचने देने के लिए बहुभुज द्वारा खोज के साथ एक उन्नत खोज मोड जोड़ें।
डुप्लिकेट फ़ेच को कम करने के लिए URL और पृष्ठ द्वारा कैश करें; समय-समय पर ताज़ा करें।

FAQ

रियल-टाइम Zillow डेटा API किस प्रमाणीकरण का उपयोग करता है?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें। कुंजी को क्वेरी स्ट्रिंग में न डालें।

मैं परिणामों को कैसे पृष्ठांकित करूं?
जहां समर्थित हो (जैसे, खोज एंडपॉइंट) वहां page क्वेरी पैरामीटर का उपयोग करें। जब तक परिणाम डेटा आइटम लौटाते रहें, पृष्ठ बढ़ाएं।

क्या मैं खींची गई आकृति के भीतर खोज सकता हूं?
हाँ। बहुभुज द्वारा खोज पथ का उपयोग करें और बहुभुज क्वेरी पैरामीटर को सटीक रूप से निर्देशांक जोड़ों के अनुक्रम के रूप में पास करें (नमूना cURL में दिखाया गया प्रारूप)।

कौन सी इकाइयाँ और मुद्रा का उपयोग किया जाता है?
मूल्य और zestimate USD में हैं। livingArea और area वर्ग फुट में हैं; lotAreaUnit भी sqft लौट सकता है।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

शिप करने के लिए तैयार? अपना परीक्षण शुरू करें, एक कुंजी प्राप्त करें, और रियल-टाइम Zillow डेटा API के खिलाफ ऊपर दिए गए cURL को चलाएं। आपका अगला कदम: मार्केटप्लेस आइटम खोलें और यहां सब्सक्राइब करें: रियल-टाइम Zillow डेटा API पर 7-दिन का परीक्षण शुरू करें।