रीयल-टाइम ज़िलो डेटा एपीआई के साथ काम करना

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

रीयल-टाइम ज़िलो डेटा एपीआई के साथ आप क्या बना सकते हैं

रीयल-टाइम ज़िलो डेटा एपीआई खोज अंत बिंदुओं को उजागर करता है जो संपत्ति की लिस्टिंग और मेटाडेटा जैसे ज़पिड, पता, समन्वय, घर का प्रकार, कीमत और मुद्रा, ज़ेस्टिमेट और किराया ज़ेस्टिमेट, आंका गया मूल्य, बेड, बाथ, रहने का क्षेत्र, ज़िलो पर दिन, और अधिक लौटाते हैं। आप:

• एक मानव-पठनीय स्थान जैसे "लॉस एंजेलेस, CA" द्वारा खोजें।
• अक्षांश/देशांतर के चारों ओर एक त्रिज्या के भीतर खोजें।
• जटिल पड़ोस के आकार या कस्टम सेवा क्षेत्रों से मेल खाने के लिए एक मनमाने बहुभुज के अंदर खोजें।

विशिष्ट एकीकरण में खरीदार/किरायेदार खोज ऐप, भू-फ़िल्टर के साथ एजेंट डैशबोर्ड, संपत्ति विश्लेषण, और तात्कालिक तुलना उपकरण शामिल हैं।

ज़ाइला एपीआई हब पर शुरू करना

ज़ाइला एपीआई हब पर रीयल-टाइम ज़िलो डेटा एपीआई लिस्टिंग खोलें और अनुरोध करना शुरू करने के लिए सदस्यता लें। ज़ाइला एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। इस एपीआई के लिए, आप लिस्टिंग पृष्ठ से सीधे 7-दिन का परीक्षण शुरू कर सकते हैं। एक खाता और एक एपीआई कुंजी 10,000 से अधिक सार्वजनिक एपीआई के कैटलॉग में काम करती है।

रीयल-टाइम ज़िलो डेटा एपीआई पर 7-दिन का परीक्षण शुरू करें

सदस्यता लेने के बाद, आपको एक एपीआई कुंजी मिलेगी। हर अनुरोध को हेडर के साथ प्रमाणित करें: Authorization: Bearer YOUR_API_KEY.

आप जिन अंत बिंदुओं का उपयोग करेंगे

नीचे तीन उपलब्ध अंत बिंदु हैं। प्रत्येक एक स्थिति, अनुरोध_id, अनुरोध पैरामीटर को वापस दर्शाता है, और लिस्टिंग का डेटा एरे लौटाता है। प्रत्येक अंत बिंदु के लिए दिखाए गए पैरामीटर का ही उपयोग करें।

1) खोजें — शहर, पड़ोस, काउंटी, या ज़िप द्वारा

जब आपके पास एक मानव-पठनीय स्थान का नाम हो तो इसका उपयोग करें। यह वैकल्पिक पृष्ठांकन और घर की स्थिति द्वारा फ़िल्टरिंग का समर्थन करता है।

• विधि: GET
• यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• आवश्यक क्वेरी पैरामीटर:
  • स्थान (स्ट्रिंग): उदाहरण के लिए, लॉस एंजेलेस, CA
• वैकल्पिक क्वेरी पैरामीटर:
  • पृष्ठ (स्ट्रिंग): पृष्ठ संख्या
  • घर की स्थिति (स्ट्रिंग): उदाहरण के लिए, 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 (स्ट्रिंग): स्थिर संपत्ति पहचानकर्ता।
• detailUrl (स्ट्रिंग): लिस्टिंग पृष्ठ देखने के लिए गहरा लिंक।
• कीमत, मुद्रा, ज़ेस्टिमेट, किराया ज़ेस्टिमेट (संख्याएँ और मुद्रा): मूल्य निर्धारण संदर्भ।
• बेडरूम, बाथरूम, रहने का क्षेत्र, क्षेत्र (संख्याएँ): घर की विशिष्टताएँ; क्षेत्र/रहने का क्षेत्र मौजूद होने पर वर्ग फुट में होते हैं।
• अक्षांश, देशांतर और latLong: मानचित्रण।
• घर की स्थिति/स्थिति प्रकार/स्थिति पाठ: लिस्टिंग स्थिति संकेत (जैसे, FOR_SALE)।
• ज़िलो पर दिन/ज़िलो पर समय: बाजार ताजगी।

पायथन उदाहरण (अनुरोध):

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) समन्वय द्वारा खोजें — केंद्र बिंदु + व्यास

इसका उपयोग करें ताकि आप केंद्र अक्षांश/देशांतर के चारों ओर एक वृत्ताकार क्षेत्र में संपत्तियों को खोज सकें। "मेरे पास" सुविधाओं या किसी स्थान के निकटता के लिए सहायक।

• विधि: GET
• यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• आवश्यक क्वेरी पैरामीटर:
  • long (स्ट्रिंग): देशांतर
  • lat (स्ट्रिंग): अक्षांश
• वैकल्पिक क्वेरी पैरामीटर:
  • व्यास (स्ट्रिंग): खोज व्यास

cURL:

उदाहरण JSON:

नोट्स:

• समन्वय दशमलव डिग्री में हैं। क्वेरी पैरामीटर के यूआरएल एन्कोडिंग को सुनिश्चित करें।
• डेटा पेलोड में खोज अंत बिंदु के समान कोर फ़ील्ड शामिल हैं।

3) बहुभुज द्वारा खोजें — कस्टम क्षेत्र सीमाएँ

इसका उपयोग करें जब एक वृत्त पर्याप्त सटीक न हो। "लॉन्ग लैट" समन्वय जोड़े की एक अनुक्रम के रूप में एक बहुभुज प्रदान करें जो अल्पविराम द्वारा अलग किए जाते हैं। यह असमान पड़ोस, स्कूल क्षेत्रों, या सेवा क्षेत्रों से मेल खाने के लिए आदर्श है। अंत बिंदु सभी फ़िल्टर और विकल्पों का समर्थन करता है जो Zillow.com पर उपलब्ध हैं।

• विधि: GET
• यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• आवश्यक क्वेरी पैरामीटर:
  • polygon (स्ट्रिंग): क्रमबद्ध "देशांतर अक्षांश" जोड़े जो अल्पविराम द्वारा अलग किए जाते हैं (उदाहरण देखें)

cURL:

उदाहरण JSON:

नोट्स:

• प्रत्येक शीर्ष बिंदु को "देशांतर अक्षांश" के रूप में प्रारूपित करें। शीर्ष बिंदुओं को अल्पविराम से अलग करें।
• बहुभुज स्ट्रिंग को यूआरएल-एन्कोड करें। ऊपर दिए गए उदाहरण में "+" का उपयोग करके स्थानों और "%2C" का उपयोग करके पैरामीटर मान के भीतर अल्पविराम के लिए उचित एन्कोडिंग दिखाता है।

व्यावहारिक कार्यान्वयन विवरण

• प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY शामिल करें।
• पृष्ठांकन: खोज और पृष्ठांकन-समर्थित अंत बिंदुओं पर पृष्ठ पैरामीटर का उपयोग करें ताकि बाद के परिणाम पृष्ठों को लाया जा सके। एपीआई अनुरोध किए गए पृष्ठ को पैरामीटर ऑब्जेक्ट में दर्शाता है।
• इकाइयाँ और मुद्रा:
  • मुद्रा आमतौर पर "USD" होती है। countryCurrency में "$" प्रतीक शामिल हो सकता है।
  • livingArea/area और lotAreaValue मान वर्ग फुट में होते हैं जब lotAreaUnit "sqft" होता है।
• फ़िल्टरिंग: home_status को FOR_SALE पर सेट किया जा सकता है (जैसा कि दिखाया गया है)। Zillow.com पर अतिरिक्त फ़िल्टर समर्थित हैं; वर्तमान विकल्पों के लिए एपीआई पृष्ठ पर परामर्श करें।
• समन्वय: अक्षांश/देशांतर दशमलव डिग्री में होते हैं।
• कैशिंग: उन लिस्टिंग फ़ीड के लिए जो अक्सर बदलते हैं (ज़िलो पर दिन, कीमत अपडेट), छोटे जीवनकाल की कैशिंग और उपयोगकर्ता इंटरैक्शन पर शर्तीय ताज़ा जोड़ें।
• डीप लिंक: detailUrl लिस्टिंग पृष्ठ को वेबव्यू या बाहरी ब्राउज़र में खोल सकता है।
• कोटा: पहुँच सदस्यता + कोटा है। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जाँच करें।

वास्तविक दुनिया के उपयोग के मामले जिन्हें आप जल्दी भेज सकते हैं

• खरीदार खोज पृष्ठ: स्थान द्वारा खोज से शुरू करें, फिर जब उपयोगकर्ता मानचित्र पर खींचते हैं तो बहुभुज द्वारा खोज पर स्विच करें। कीमत, बेड, बाथ दिखाएं, और प्रत्येक कार्ड को detailUrl से लिंक करें।
• एजेंट CMA/तुलनाएँ: विषय संपत्ति के चारों ओर 1–2 मील व्यास के भीतर लिस्टिंग एकत्र करने के लिए समन्वय द्वारा खोज का उपयोग करें; त्वरित मूल्यांकन संदर्भ के लिए ज़ेस्टिमेट और किराया ज़ेस्टिमेट को सतह पर लाएं।
• पड़ोस अन्वेषक: प्रत्येक पड़ोस के लिए बहुभुज सीमाएँ पूर्वनिर्धारित करें और सुनिश्चित करें कि परिणाम स्थानीय, असमान सीमाओं का सम्मान करते हैं।
• मोबाइल "मेरे पास": स्थान अनुमति पर, उपयोगकर्ता के जीपीएस स्थिति का उपयोग करके समन्वय द्वारा खोज करें, छोटे व्यास के साथ परिणामों को प्रासंगिक रखने के लिए।

MCP के माध्यम से एआई एजेंट से इस एपीआई को कॉल करना

आप इन अंत बिंदुओं को एक MCP-संगत क्लाइंट से भी चला सकते हैं। अपने एजेंट को ज़ाइला MCP अंत बिंदु पर इंगित करें और अपनी उसी एपीआई कुंजी का उपयोग करें:

MCP

अंत बिंदु: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

• अपने MCP क्लाइंट से, उन उपकरण कॉल जारी करें जो ऊपर दिखाए गए समान हब यूआरएल पर HTTPS GET अनुरोध करते हैं।
• cURL उदाहरणों में ठीक उसी तरह Authorization: Bearer YOUR_API_KEY हेडर भेजें।
• प्रॉम्प्ट और एजेंट प्रवाह में स्थिर व्यवहार के लिए क्वेरी स्ट्रिंग्स को यहाँ के नमूनों के समान रखें।

समस्या निवारण और गोटचास

• 401 या 403 त्रुटियाँ: पुष्टि करें कि Authorization हेडर मौजूद है और एपीआई कुंजी आपकी सदस्यता के लिए मान्य है।
• खाली डेटा एरे: सत्यापित करें कि आपके फ़िल्टर बहुत प्रतिबंधात्मक नहीं हैं; home_status को हटाने या बहुभुज/व्यास को समायोजित करने का प्रयास करें।
• गलत बहुभुज: सुनिश्चित करें कि प्रत्येक बिंदु "लॉन्ग लैट" है, "लैट लॉन्ग" नहीं, और कि पूरी स्ट्रिंग यूआरएल-एन्कोडेड है।
• पृष्ठांकन भ्रम: एपीआई अनुरोध किए गए पृष्ठ को parameters.page के तहत दर्शाता है। परिणाम सेट को पार करने के लिए पृष्ठ बढ़ाएँ।
• स्थान और अल्पविराम एन्कोडिंग: यूआरएल में, स्थानों को + या %20 के रूप में एन्कोड किया जाना चाहिए, और अल्पविराम को क्वेरी पैरामीटर मानों के भीतर %2C के रूप में।

अक्सर पूछे जाने वाले प्रश्न

मैं अनुरोधों को कैसे प्रमाणित करूं?
प्रत्येक अनुरोध पर हेडर Authorization: Bearer YOUR_API_KEY शामिल करें।

क्या मैं लिस्टिंग स्थिति द्वारा फ़िल्टर कर सकता हूँ?
हाँ। जहाँ समर्थित हो, खोज और समन्वय/बहुभुज खोजों पर home_status=FOR_SALE सेट करें।

मैं पड़ोस के आकार के भीतर कैसे खोजूं?
पड़ोस की सीमा को ट्रेस करने वाले "देशांतर अक्षांश" जोड़ों की क्रमबद्ध सूची के साथ बहुभुज द्वारा खोज अंत बिंदु का उपयोग करें, यूआरएल-एन्कोडेड।

क्षेत्र मानों के लिए कौन सी इकाइयाँ उपयोग की जाती हैं?
जब lotAreaUnit "sqft" होता है, तो lotAreaValue वर्ग फुट में होता है। जब मौजूद होते हैं तो livingArea/area मान भी वर्ग फुट में होते हैं।

मैं पहुँच विकल्पों और कोटा को कहाँ देख सकता हूँ?
वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए ज़ाइला एपीआई हब पर एपीआई पृष्ठ की जाँच करें। सदस्यताएँ एक कोटा मॉडल का उपयोग करती हैं, न कि पे-पर-कॉल।

क्या आप अपने ऐप में रीयल-टाइम संपत्ति खोज को एकीकृत करने के लिए तैयार हैं? यहाँ अपने 7-दिन के परीक्षण को शुरू करें और अपनी एपीआई कुंजी प्राप्त करें: रीयल-टाइम ज़िलो डेटा एपीआई पर 7-दिन का परीक्षण शुरू करें. ज़ाइला एपीआई हब कैटलॉग में एक खाता और कुंजी का उपयोग करें और अपनी रियल एस्टेट सुविधाओं को तेजी से भेजें।