निर्देशांक द्वारा खोजने के लिए API

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

यह API क्या करती है और यह भू-स्थान खोज के लिए क्यों उपयुक्त है

रियल-टाइम ज़िलो डेटा API लाइव आवासीय संपत्ति डेटा लौटाती है जो स्थान-आधारित खोज के लिए उपयुक्त है। आप:

• स्थान नाम (शहर, काउंटी, पड़ोस, या ZIP) द्वारा खोजें।
• एक केंद्र बिंदु और व्यास का उपयोग करके भौगोलिक निर्देशांक द्वारा खोजें।
• कस्टम-खींची गई सीमाओं के लिए मनमाने बहुभुज के अंदर खोजें।

प्रत्येक प्रतिक्रिया में वे फ़ील्ड शामिल होते हैं जिन्हें डेवलपर्स वास्तव में मानचित्र या परिणाम सूची पर प्रदर्शित करते हैं: zpid, address, latitude, longitude, price, homeStatus, bedrooms, bathrooms, livingArea, मीडिया संदर्भ, और अधिक। ये वही प्रकार के फ़ील्ड हैं जिनका उपयोग ऐप्स मानचित्र पर खोज, "मेरे पास घर" अनुभव, और भू-सीमाबद्ध अलर्ट को शक्ति देने के लिए करते हैं।

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

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

रियल-टाइम ज़िलो डेटा API लिस्टिंग को Zyla API Hub पर खोलें, सब्सक्राइब पर क्लिक करें या 7-दिन का परीक्षण शुरू करें, और अपनी API कुंजी कॉपी करें। नीचे सभी कॉल हेडर का उपयोग करते हैं:

• Authorization: Bearer YOUR_API_KEY

प्लेटफ़ॉर्म सदस्यता + कोटा का उपयोग करता है। कोई मुफ्त योजना नहीं है; यहाँ पहला API 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है ताकि आप निर्माण और परीक्षण कर सकें।

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

नीचे तीन भू-स्थान-केंद्रित एंडपॉइंट्स हैं। प्रत्येक एक Zyla Hub URL पर GET है, और प्रत्येक एक parameters इको और लिस्टिंग के data एरे के साथ JSON पेलोड लौटाता है।

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

इसका उपयोग करें जब आपके पास एक केंद्र बिंदु हो और आप निर्दिष्ट व्यास के भीतर लिस्टिंग चाहते हों।

• Method: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• Description: एक विशिष्ट भौगोलिक स्थान में संपत्तियों के लिए खोजें, एक केंद्र अक्षांश, देशांतर बिंदु और एक व्यास द्वारा।
• Required parameters:
  • long (string): -118.504744
  • lat (string): 34.01822
• Optional parameters:
  • diameter (string): 2

आधिकारिक 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"

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

{
"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…

कार्यान्वयनकर्ताओं के लिए नोट्स:

• latitude और longitude का उपयोग मानचित्र मार्करों के लिए करें।
• homeStatus और price का उपयोग फ़िल्टर और बैज के लिए करें।
• parameters ऑब्जेक्ट पृष्ठांकन और डिफ़ॉल्ट फ़िल्टर को वापस इको करता है जहाँ लागू हो।

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

इसका उपयोग करें जब उपयोगकर्ता मानचित्र पर एक सीमा खींचता है। आप खोज क्षेत्र को सीमित करने के लिए क्रमबद्ध निर्देशांक जोड़े भेजते हैं।

• Method: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• Description: एक विशिष्ट भौगोलिक बहुभुज क्षेत्र में संपत्तियों के लिए खोजें। जो लोग अपनी खोज सीमाओं पर अधिक नियंत्रण चाहते हैं, उनके लिए यह सुविधा जटिल या गैर-मानक भौगोलिक क्षेत्रों में संपत्तियों को खोजने में सक्षम बनाती है। Zillow.com पर उपलब्ध सभी फ़िल्टर और विकल्पों का समर्थन करें।
• Required parameters:
  • polygon (string): -118.50394248962402 34.02926010734425, -118.5084056854248 34.02926010734425, -118.51286888122559 34.028691046671696, -118.51527214050293 34.02570341552858, -118.51321220397949 34.02257340341831, -118.51750373840332 34.0215774662657, -118.51681709289551 34.017878168811684, -118.51286888122559 34.016455319170184, -118.51080894470215 34.013324966013194, -118.50789070129395 34.010621386310234, -118.50411415100098 34.008629219864694, -118.49982261657715 34.008486920473, -118.49570274353027 34.007063913440916, -118.4919261932373 34.00891381793271, -118.48849296569824 34.01119056813859, -118.4860897064209 34.014463289606894, -118.48471641540527 34.018020452464164, -118.48042488098145 34.01858958468914, -118.4780216217041 34.0215774662657, -118.47939491271973 34.0249920592766, -118.47681999206543 34.02797971546417, -118.47493171691895 34.03125178964367, -118.4721851348877 34.034381481654364, -118.47733497619629 34.035377268536706, -118.48231315612793 34.035377268536706, -118.48677635192871 34.035377268536706, -118.49141120910645 34.03495050416125, -118.49604606628418 34.034096968969656, -118.49621772766113 34.03054047990366, -118.50033760070801 34.02926010734425, -118.50239753723145 34.032532132148006, -118.50394248962402 34.02926010734425

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

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

कार्यान्वयनकर्ताओं के लिए नोट्स:

• "longitude latitude" जोड़ों की एक अल्पविराम से पृथक सूची के रूप में बहुभुज भेजें।
• API Zillow.com पर उपलब्ध फ़िल्टर का समर्थन करता है। मानचित्र पर खींचने और पड़ोस ओवरले के लिए बहुभुज खोज का उपयोग करें।

3) स्थान (शहर, पड़ोस, ZIP) द्वारा खोजें

इसका उपयोग करें जब आप पहले से ही एक सामान्य स्थान स्ट्रिंग जानते हों।

• Method: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• Description: स्थान (काउंटी, पड़ोस, शहर, या ज़िप कोड) द्वारा संपत्तियों के लिए खोजें।
• Required parameters:
  • location (string): Los Angeles, CA
• Optional parameters:
  • page (string): 2
  • home_status (string): FOR_SALE

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

आधिकारिक JSON (शब्दशः):

डेवलपर की बातें:

• parameters.page वर्तमान पृष्ठ दिखाता है। इसका उपयोग "अगला पृष्ठ" पृष्ठांकन लागू करने के लिए करें।
• imgSrc, detailUrl, और statusText जैसे फ़ील्ड आपको जल्दी से कार्ड प्रदर्शित करने में मदद करते हैं।

निर्देशांक खोज के लिए एक कार्यशील कोड नमूना (Python)

निम्नलिखित Python उदाहरण निर्देशांक द्वारा खोज को कॉल करता है और प्रत्येक संपत्ति के लिए एक संकुचित पंक्ति प्रिंट करता है। यह केवल ऊपर दिए गए उदाहरण से प्रलेखित पैरामीटर और फ़ील्ड का उपयोग करता है।

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates"
params = {
"long": "-118.504744",
"lat": "34.01822",
"diameter": "2"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

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

print(f"Status: {payload.get('status')} Request ID: {payload.get('request_id')}")
p = payload.get("parameters", {})
print(f"Center: ({p.get('lat')}, {p.get('long')}) diameter={p.get('diameter')} page={p.get('page')}")

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
city = item.get("city")
state = item.get("state")
price = item.get("price")
beds = item.get("bedrooms")
baths = item.get("bathrooms")
lat = item.get("latitude")
lon = item.get("longitude")
status = item.get("homeStatus")
print(f"{zpid} | {status} | ${price} | {beds} bd / {baths} ba | {addr} | {city}, {state} | ({lat}, {lon})")

क्या अनुकूलित करना है:

• जब उपयोगकर्ता पैन/ज़ूम करता है तो lat और long को आपके मानचित्र के केंद्र से बंधें।
• डुप्लिकेशन या विवरण रूटिंग के लिए zpid का उपयोग करें।
• यदि आप पृष्ठांकित फ़ेचिंग जोड़ते हैं तो parameters.page को इको करें; अतिरिक्त कॉल से बचने के लिए केंद्र और पृष्ठ द्वारा कैश करें।

आप वास्तव में उपयोग करेंगे JSON के लिए क्षेत्र गाइड

उपरोक्त आधिकारिक नमूनों से, अधिकांश ऐप्स तुरंत इन फ़ील्ड्स को वायर करते हैं:

• data[].latitude, data[].longitude: आपके मानचित्र प्रक्षिप्ति पर मार्कर प्लेसमेंट।
• data[].address, data[].city, data[].state, data[].zipcode: खोज परिणाम सारांश और विवरण शीर्षक।
• data[].price और data[].currency: मूल्य निर्धारण प्रदर्शन।
• data[].homeStatus (जैसे, FOR_SALE): फ़िल्टरिंग और बैज।
• data[].bedrooms, data[].bathrooms, data[].livingArea: फ़िल्टर और सूची-आइटम तथ्य।
• data[].imgSrc और data[].detailUrl: नायक छवियाँ और बाहरी विवरण गहरे लिंक (स्थान-खोज नमूने में मौजूद)।
• parameters.page: जब पृष्ठांकन UX जोड़ते हैं तो उपयोग करें।

समय-बचत कार्यान्वयन नोट्स:

• कैशिंग: उपयोगकर्ताओं द्वारा हल्का पैन करते समय दोहराए गए कॉल को कम करने के लिए पूर्ण अनुरोध URL (क्वेरी स्ट्रिंग सहित) द्वारा कैश करें।
• पृष्ठांकन: प्रतिक्रिया में parameters.page इको शामिल है। "और अधिक लोड करें" के लिए इसे अपने राज्य में रखें।
• भू-खोज UX: निर्देशांक और बहुभुज खोजों के लिए, अत्यधिक अनुरोधों से बचने के लिए केवल निष्क्रिय या ड्रैग-समापन घटनाओं के बाद क्वेरी को फिर से गणना करें।

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

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

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

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, या कोई भी MCP क्लाइंट) का उपयोग करते हैं, तो आपका एजेंट Zyla के MCP गेटवे के माध्यम से समान HTTPS एंडपॉइंट्स को कॉल कर सकता है https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। यह एजेंट को आपके मौजूदा कुंजी के साथ रियल-टाइम ज़िलो डेटा API को सक्रिय करने और परिणामों को IDE या रनटाइम में स्ट्रीम करने की अनुमति देता है। MCP के लिए एडेप्टर विवरण देखें।

एकीकरण चेकलिस्ट

• API लिस्टिंग से अपनी कुंजी प्राप्त करें और इसे सुरक्षित रूप से स्टोर करें (जैसे, सर्वर-साइड या CI/CD में प्रबंधित रहस्य)।
• अपना खोज मोड चुनें:
  • केंद्र + व्यास निकटता के लिए निर्देशांक।
  • उपयोगकर्ता-खींची गई सीमाओं के लिए बहुभुज।
  • शहर/ZIP/पड़ोस बूटस्ट्रैप के लिए स्थान।
• आवश्यक फ़ील्ड प्रदर्शित करें:
  • latitude/longitude से मानचित्र मार्कर।
  • जब मौजूद हों तो address, price, bedrooms, bathrooms, livingArea, और छवि URL से कार्ड।
• यदि आप कई परिणाम सूचीबद्ध करते हैं तो page पैरामीटर और parameters.page में इसके इको का उपयोग करके पृष्ठांकन लागू करें।
• पूर्ण URL द्वारा क्वेरी कैश करें; जब मानचित्र केंद्र या बहुभुज बदलता है तो अमान्य करें।

समस्या निवारण टिप्स

• प्राधिकरण विफलताएँ: सुनिश्चित करें कि हेडर बिल्कुल Authorization: Bearer YOUR_API_KEY है।
• खाली परिणाम: अपने location, lat/long, या polygon मान और home_status जैसे किसी भी वैकल्पिक फ़िल्टर को सत्यापित करें।
• बहुभुज प्रारूपण: "longitude latitude" जोड़ों की एक अल्पविराम से पृथक सूची भेजें; क्वेरी स्ट्रिंग बनाने के समय स्थानों/अल्पविरामों के लिए URL एन्कोडिंग सुनिश्चित करें।
• लेटेंसी: मानचित्र पैन के दौरान कॉल को बाढ़ से बचाने के लिए ड्रैग-समापन या डेबाउंस अपने इनपुट से अनुरोधों को स्थगित करें।

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

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

मुझे पहचानकर्ताओं के रूप में कौन से फ़ील्ड स्टोर करने चाहिए?
zpid स्थिर संपत्ति पहचानकर्ता है। इसका उपयोग डुप्लिकेशन, बुकमार्क, और विवरण स्क्रीन पर रूटिंग के लिए करें।

क्या मैं विशिष्ट लिस्टिंग स्टेटस के लिए फ़िल्टर कर सकता हूँ?
जहाँ समर्थित हो, home_status (जैसे, FOR_SALE) को ठीक उसी तरह पास करें जैसा कि एंडपॉइंट पैरामीटर में दिखाया गया है और प्रतिक्रिया के parameters इको में इसकी पुष्टि करें।

मूल्य और क्षेत्र के लिए कौन से इकाइयाँ उपयोग की जाती हैं?
पेलोड में price currency (जैसे, USD) के साथ शामिल होता है और जहाँ मौजूद हो livingArea या लॉट फ़ील्ड शामिल हो सकते हैं। लौटाए गए मानों को प्रदर्शित करें; परिवर्तनों का अनुमान न लगाएं।

क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। किसी भी MCP-संगत क्लाइंट से https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP गेटवे का उपयोग करें। विवरण के लिए MCP पृष्ठ देखें।

इसे शिप करें

अपनी API कुंजी प्राप्त करें और निर्देशांक, बहुभुज, या स्थान नाम द्वारा संपत्तियों को क्वेरी करना शुरू करें। अपना खाता बनाएं और यहाँ रियल-टाइम ज़िलो डेटा API पर 7-दिन का परीक्षण शुरू करें: रियल-टाइम ज़िलो डेटा API पर 7-दिन का परीक्षण शुरू करें। Zyla API Hub पर 10,000 से अधिक सार्वजनिक APIs के साथ, आप अधिक प्रमाणीकरण प्रवाह या बिलिंग सिस्टम जोड़े बिना अपने भू-स्थान सुविधाओं का विस्तार कर सकते हैं।