कैसे रियल-टाइम ज़िलो डेटा एपीआई का उपयोग करें

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

यह एपीआई क्या करता है और इसका उपयोग कब करें

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

• स्थान (शहर, काउंटी, पड़ोस, या ज़िप) द्वारा खोजें जिसमें पृष्ठांकन और स्थिति फ़िल्टर हैं।
• एक लाट/लॉन्ग बिंदु के चारों ओर एक व्यास (मील या किलोमीटर जो हब डॉक में निर्दिष्ट नहीं हैं; इसे एक अमूर्त “खोज त्रिज्या” के रूप में मानें) के साथ खोजें।
• एक मनमाने बहुभुज के भीतर खोजें ताकि बारीक भौगोलिक सीमाएँ मिल सकें।

विशिष्ट एकीकरणों में प्रॉपर्टी सर्च यूआई, लीड राउटिंग जो लिस्टिंग जियोफेंस पर आधारित होती है, दैनिक कॉम्प्स रिफ्रेश जॉब्स, और अलर्टिंग सिस्टम शामिल हैं जो तब ट्रिगर होते हैं जब नए “FOR_SALE” लिस्टिंग एक बहुभुज के भीतर दिखाई देते हैं।

यह एपीआई Zyla API Hub पर उपलब्ध है, जो एक मार्केटप्लेस है जिसमें एक खाते के तहत 10,000 से अधिक सार्वजनिक एपीआई हैं, एक एपीआई कुंजी, और एक सदस्यता मॉडल।

Zyla API Hub पर शुरुआत करना

एक एपीआई कुंजी प्राप्त करने के लिए:

1. रियल-टाइम ज़िलो डेटा एपीआई पृष्ठ खोलें और एक परीक्षण शुरू करें: रियल-टाइम ज़िलो डेटा एपीआई पर 7-दिन का परीक्षण शुरू करें.
2. सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें) और अपनी एपीआई कुंजी प्राप्त करें।
3. Authorization हेडर में कुंजी का उपयोग करें जैसे: Authorization: Bearer YOUR_API_KEY.

Zyla पर बिलिंग सदस्यता + कोटा है (पे-पर-कॉल नहीं)। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

आप आज जिन एंडपॉइंट्स को कॉल कर सकते हैं

सभी अनुरोध Zyla Hub URLs के लिए GET हैं और आपके Authorization हेडर को शामिल करना चाहिए। नीचे तीन उपलब्ध एंडपॉइंट्स उनके सटीक URLs और पैरामीटर के साथ दिए गए हैं।

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

विधि: GET

URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search

पैरामीटर:

• स्थान (string, आवश्यक): उदाहरण के लिए, लॉस एंजेलेस, CA
• पृष्ठ (string, वैकल्पिक): उदाहरण के लिए, 2
• होम_स्टेटस (string, वैकल्पिक): उदाहरण के लिए, FOR_SALE

आधिकारिक कर्ल (कॉपी/पेस्ट):

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"

आधिकारिक उदाहरण प्रतिक्रिया:

{
"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: अद्वितीय लिस्टिंग पहचानकर्ता जिसे आप अपने DB में स्टोर कर सकते हैं और एक इडेम्पोटेंट कुंजी के रूप में उपयोग कर सकते हैं।
• मूल्य और मुद्रा: संख्यात्मक पूछ मूल्य और इसकी मुद्रा (जैसे, USD)।
• पता, शहर, राज्य, ज़िपकोड: आपके UI के लिए प्रदर्शन और जियोकोडिंग जानकारी।
• बेडरूम, बाथरूम, लिविंग एरिया: फ़िल्टर और बैज के लिए मुख्य विशिष्टताएँ।
• अक्षांश, देशांतर (और latLong): मानचित्र स्थान और निकटता गणना।
• zestimate और rentZestimate: मूल्य निर्धारण संदर्भ के लिए संदर्भ मान।
• homeStatus (जैसे, FOR_SALE) और daysOnZillow: स्थिति और हालियत।

पृष्ठांकन: परिणाम पृष्ठों के माध्यम से कदम रखने के लिए पृष्ठ पैरामीटर का उपयोग करें। प्रतिक्रिया इनपुट पृष्ठ को प्रतिध्वनित करती है। अपने पृष्ठांकन UI/कार्यकर्ता को बनाएं ताकि आपकी रोकने की स्थिति (जैसे कोई और परिणाम नहीं) के आधार पर पृष्ठ को बढ़ाया जा सके।

2) निर्देशांक द्वारा खोजें (केंद्र बिंदु + व्यास)

विधि: GET

URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates

पैरामीटर:

• long (string, आवश्यक): उदाहरण के लिए, -118.504744
• lat (string, आवश्यक): उदाहरण के लिए, 34.01822
• diameter (string, वैकल्पिक): उदाहरण के लिए, 2

आधिकारिक कर्ल (कॉपी/पेस्ट):

उदाहरण प्रतिक्रिया (हब लिस्टिंग द्वारा प्रदान किया गया अंश):

जब उपयोगकर्ता एक केंद्र बिंदु के चारों ओर मानचित्र को स्थानांतरित करते हैं या जब आप एक स्टोर, स्कूल, या परिवहन स्टेशन के चारों ओर जियोफेंस करते हैं, तो इसका उपयोग करें। प्रतिक्रिया में खोज एंडपॉइंट के समान मुख्य क्षेत्र शामिल हैं।

3) बहुभुज द्वारा खोजें (मनमाना जियोफेंस)

विधि: GET

URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon

पैरामीटर:

• polygon (string, आवश्यक): लंबाई और चौड़ाई के निर्देशांक के स्पेस-सेपरेटेड जोड़े (उस क्रम में), अल्पविराम द्वारा अलग किए गए। नीचे उदाहरण प्रदान किया गया है।

आधिकारिक कर्ल (कॉपी/पेस्ट):

उदाहरण प्रतिक्रिया (हब लिस्टिंग द्वारा प्रदान किया गया अंश):

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

प्रमाणीकरण और हेडर

• हेडर: Authorization: Bearer YOUR_API_KEY
• हब दस्तावेज़ में कोई अन्य हेडर आवश्यक नहीं हैं।
• नीचे सभी उदाहरण zylalabs.com पर हब URLs को ठीक उसी तरह लक्षित करते हैं जैसे दिखाया गया है।

न्यूनतम पायथन उदाहरण: लॉस एंजेलेस “FOR_SALE” लिस्टिंग खोजें (पृष्ठ 2)

यह उदाहरण खोज एंडपॉइंट को कॉल करता है और एक सामान्य लिस्टिंग कार्ड को आवश्यक मुख्य क्षेत्रों को निकालता है। यह आधिकारिक कर्ल के पैरामीटर को दर्शाता है।

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=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", []):
listing = {
"zpid": item.get("zpid"),
"status": item.get("homeStatus") or item.get("statusType"),
"price": item.get("price"),
"currency": item.get("currency"),
"address": item.get("address"),
"city": item.get("city") or item.get("addressCity"),
"state": item.get("state") or item.get("addressState"),
"zipcode": item.get("zipcode") or item.get("addressZipcode"),
"bedrooms": item.get("bedrooms") or item.get("beds"),
"bathrooms": item.get("bathrooms") or item.get("baths"),
"livingArea": item.get("livingArea") or item.get("area"),
"latitude": item.get("latitude") or (item.get("latLong") or {}).get("latitude"),
"longitude": item.get("longitude") or (item.get("latLong") or {}).get("longitude"),
"zestimate": item.get("zestimate"),
"rentZestimate": item.get("rentZestimate"),
"detailUrl": item.get("detailUrl"),
"imgSrc": item.get("imgSrc"),
"daysOnZillow": item.get("daysOnZillow")
}
print(listing)

नोट्स:

• प्रतिक्रिया में सामान्यीकृत क्षेत्र (जैसे, बेडरूम, बाथरूम) और कभी-कभी वैकल्पिक नाम (बेड्स, बाथ्स, क्षेत्र) दोनों शामिल होते हैं। ऊपर का नमूना दोनों की जांच करता है।
• Lat/long शीर्ष स्तर पर और latLong के अंदर दोनों पर दिखाई दे सकता है। यदि आवश्यक हो तो स्निपेट वापस गिरता है।
• लॉगिंग और पुनः प्रयासों के बीच संबंध के लिए request_id का उपयोग करें।

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

• पृष्ठांकन: पृष्ठ पैरामीटर हब इंटरफेस में एक स्ट्रिंग है। इसे स्ट्रिंग के रूप में बढ़ाएं (“1”, “2”, “3”, …)। जब आपका ऐप यह तय करता है कि कोई और प्रासंगिक परिणाम नहीं हैं तो रुकें।
• स्थिति द्वारा फ़िल्टरिंग: home_status उन मानों को स्वीकार करता है जैसे FOR_SALE (जैसा दिखाया गया है)। अपने UI फ़िल्टर को उन अनुमत मानों के साथ संरेखित रखें जिन्हें आप पास करते हैं।
• स्थान क्वेरी: स्थान मानव-पठनीय इनपुट स्वीकार करता है जैसे “लॉस एंजेलेस, CA”। ज़िप या पड़ोस क्वेरी के लिए, उन नामों को सीधे स्थान में पास करें।
• निर्देशांक बनाम बहुभुज: सरल वृत्ताकार खोजों के लिए निर्देशांक + व्यास को प्राथमिकता दें (जैसे, “इस बिंदु से 2 इकाइयों के भीतर”)। पड़ोस, स्कूल क्षेत्रों, या कस्टम सीमाओं के चारों ओर सटीक आकार के लिए बहुभुज का उपयोग करें।
• कैशिंग और मतदान: यदि आप समय-समय पर ताज़ा करते हैं, तो अपने DB में zpid और अद्यतन टाइमस्टैम्प स्टोर करें ताकि डुप्लिकेट न हों। प्रतिक्रिया में स्थिति और zestimate क्षेत्र शामिल होते हैं जो परिवर्तन पहचान के लिए उपयोगी होते हैं।
• इकाइयाँ और मुद्रा: नमूनों में मूल्य “USD” मुद्रा में दिखाई देते हैं। कुछ प्रतिक्रियाओं में लॉट क्षेत्र की इकाइयाँ “sqft” हो सकती हैं। स्पष्टता के लिए प्रतिक्रिया से मूल्यों को जैसे हैं, वैसे ही प्रदर्शित करें।

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

• शहर खोज पृष्ठ: कार्ड प्रदर्शित करने के लिए स्थान के साथ खोज एंडपॉइंट का उपयोग करें। पृष्ठ=2,3,… के साथ पृष्ठांकन जोड़ें।
• “मेरे पास” खोज: उपयोगकर्ता के डिवाइस स्थान पर केंद्रित निर्देशांक द्वारा खोज का उपयोग करें। अपने UX (जैसे, एक स्लाइडर) से मेल खाने के लिए व्यास को समायोजित करें।
• बहुभुज अलर्टिंग: “देखने के क्षेत्रों” के लिए उपयोगकर्ता-परिभाषित बहुभुज स्टोर करें। एक कार्यक्रम पर बहुभुज द्वारा खोज चलाएँ और जब एक नया FOR_SALE लिस्टिंग दिखाई दे (zpid द्वारा तुलना करें) तो ईमेल या पुश करें।
• मानचित्र ड्राइंग टूल: उपयोगकर्ताओं को मानचित्र पर एक आकार खींचने दें और इसे बहुभुज पैरामीटर स्ट्रिंग (लॉन्ग लैट जोड़े) में परिवर्तित करें। बहुभुज द्वारा खोज कॉल करें और परिणामों को पिन के रूप में दिखाएँ।
• लीड राउटिंग: परिणामों को ग्रहण करें और लिस्टिंग शहर या बहुभुज सदस्यता के आधार पर एजेंटों को रूट करें।

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

Zyla पर हर एपीआई को MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, और अन्य) से MCP एंडपॉइंट के माध्यम से बुलाया जा सकता है। अपने कुंजी को MCP URL क्वेरी स्ट्रिंग के माध्यम से प्रदान करें और उन उपकरण कॉल्स को जारी करें जो ऊपर देखे गए हब एंडपॉइंट्स और पैरामीटर से मेल खाते हैं। विवरण के लिए MCP देखें। एक सामान्य प्रवाह:

1. अपने MCP क्लाइंट को MCP एंडपॉइंट और अपनी कुंजी के साथ कॉन्फ़िगर करें।
2. एजेंट को इस लेख में दिखाए गए सटीक हब URLs और पैरामीटर का उपयोग करके खोज या भू-स्थानिक एंडपॉइंट्स को कॉल करने के लिए निर्देश दें।
3. डाउनस्ट्रीम कार्यों के लिए समान JSON क्षेत्रों (zpid, मूल्य, पता, zestimate, अक्षांश/देशांतर) को पार्स करें जैसे संपत्ति सारांश तैयार करना या अपने CRM को अपडेट करना।

प्रत्येक खोज शैली के लिए एंड-टू-एंड उदाहरण

शहर/ज़िप खोज

जब आपके पास एक उपयोगकर्ता-इनपुट शहर या डाक कोड हो तो इसका उपयोग करें।

UI कार्ड के लिए parse data[].zpid, data[].price, data[].address, data[].bedrooms, data[].bathrooms, data[].livingArea।

जियोफेंस त्रिज्या (मानचित्र केंद्र)

जब उपयोगकर्ता मानचित्र को पैन/ज़ूम करता है, या एक POI-केंद्रित त्रिज्या को कवर करने के लिए इसका उपयोग करें।

अक्षांश/देशांतर का उपयोग करके पिन प्रदर्शित करें और जब पिन पर क्लिक किया जाए तो detailUrl दिखाएँ।

बहुभुज सीमा

स्कूल क्षेत्रों, HOA सीमाओं, या किसी भी कस्टम ड्रॉ-ऑन-मैप कार्यप्रवाह के लिए इसका उपयोग करें। “लॉन्ग लैट” जोड़ों को एन्कोड करें, अल्पविराम द्वारा अलग करें, और स्ट्रिंग को URL-एस्केप करें।

संचालन संबंधी चिंताएँ

• त्रुटि हैंडलिंग: डिबगिंग के लिए स्थिति और request_id लॉग करें। जब परिवहन त्रुटियाँ होती हैं तो आपके ऐप के मानकों के अनुसार बैकऑफ और पुनः प्रयास लागू करें।
• कोटा: आपकी सदस्यता मासिक कोटा को नियंत्रित करती है। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें। यहाँ कोई पे-पर-कॉल नहीं है; यह सदस्यता + कोटा है।
• डेटा ताजगी: अपने उपयोगकर्ताओं की अपेक्षाओं के आधार पर अपने सिंक कैडेंस को डिज़ाइन करें। यदि आपको निकट-रियल-टाइम अपडेट की आवश्यकता है, तो छोटे भौगोलिक टुकड़ों को अधिक बार मतदान करें।
• नॉर्मलाइजेशन: अपने DB में एक व्युत्पन्न स्कीमा को बनाए रखें जिसमें आपके UI को आवश्यक क्षेत्र हों, zpid द्वारा कुंजीबद्ध, और ऑडिट करने के लिए एक स्रोत JSON कॉलम बनाए रखें।

अगला कहाँ जाएं

• Zyla पर ब्राउज़ करें और सदस्यता लें: Zyla API Hub.
• रियल-टाइम ज़िलो डेटा एपीआई को अभी एकीकृत करें: रियल-टाइम ज़िलो डेटा एपीआई पर 7-दिन का परीक्षण शुरू करें.

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

Q1: मुझे प्रमाणीकरण के लिए कौन सा हेडर चाहिए?
A1: Authorization: Bearer YOUR_API_KEY का उपयोग करें। सदस्यता लेने के बाद Zyla पर एपीआई के पृष्ठ से अपनी कुंजी प्राप्त करें।

Q2: क्या मैं केवल सक्रिय लिस्टिंग को फ़िल्टर कर सकता हूँ?
A2: हाँ। जहां समर्थित हो (जैसे, खोज एंडपॉइंट) home_status=FOR_SALE पास करें। प्रतिक्रिया आपके पैरामीटर को प्रतिध्वनित करती है ताकि आप लागू फ़िल्टरों की पुष्टि कर सकें।

Q3: मैं पृष्ठांकन को कैसे संभालूं?
A3: पृष्ठ पैरामीटर का उपयोग करें जैसे एक स्ट्रिंग और इसे अगले पृष्ठों के लिए बढ़ाएं। प्रतिक्रिया के पैरामीटर.page वर्तमान पृष्ठ को प्रतिध्वनित करता है।

Q4: निर्देशांक और बहुभुज खोजों के बीच क्या अंतर है?
A4: निर्देशांक + व्यास एकल बिंदु के चारों ओर एक वृत्ताकार खोज बनाता है। बहुभुज खोजें एक मनमानी सीमा (लॉन्ग लैट जोड़े) को सटीक जियोफेंस के लिए स्वीकार करती हैं।

Q5: क्या कोई मुफ्त योजना है?
A5: कोई मुफ्त योजना नहीं है। आप एपीआई की लिस्टिंग से परीक्षण शुरू कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

क्या आप कार्यान्वित करने के लिए तैयार हैं? मार्केटप्लेस लिस्टिंग खोलें और एपीआई कुंजी प्राप्त करने के लिए अपना परीक्षण शुरू करें: रियल-टाइम ज़िलो डेटा एपीआई। Zyla API Hub पर एक खाते के साथ, आप इस और हजारों अन्य रियल एस्टेट और हाउसिंग एपीआई को एकल कुंजी के तहत कॉल कर सकते हैं।