पते द्वारा संपत्ति के लिए एपीआई

आपको पते द्वारा संपत्तियों को देखना होगा या एक मानचित्र सीमा खींचनी होगी और लिस्टिंग वापस प्राप्त करनी होगी—इस सप्ताह, अगले तिमाही में नहीं। इस गाइड के अंत तक आप शहर/ZIP द्वारा, सटीक अक्षांश/देशांतर द्वारा, और कस्टम बहुभुज द्वारा जिओलोकेटेड संपत्ति डेटा को रियल-टाइम ज़िलो डेटा एपीआई का उपयोग करके क्वेरी करेंगे, जिसमें कॉपी-पेस्ट करने योग्य अनुरोध और एक न्यूनतम पायथन स्क्रिप्ट होगी।

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

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

Illustration: API for property by address

स्थान स्ट्रिंग (शहर, काउंटी, पड़ोस, या ज़िप कोड) द्वारा संपत्तियों की खोज करें।
अक्षांश/देशांतर और मील में व्यास का उपयोग करके मानचित्र केंद्र द्वारा खोजें।
कस्टम बहुभुज के भीतर खोजें—मानचित्र पर पड़ोस या डिलीवरी कॉरिडोर खींचने के लिए आदर्श।

विशिष्ट अनुप्रयोगों में रियल एस्टेट खोज यूआई, "मेरे पास घर" मानचित्र, पड़ोस विश्लेषण, नए FOR_SALE लिस्टिंग पर अलर्टिंग बॉट्स, और आंतरिक उपकरणों में पता-से-जीओ समृद्धि शामिल हैं—सब कुछ जिओलोकेशन में निहित है।

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

ज़ाइला एपीआई हब एक ही मार्केटप्लेस में 10,000 से अधिक सार्वजनिक एपीआई होस्ट करता है। रियल-टाइम ज़िलो डेटा एपीआई का उपयोग करने के लिए:

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

एंडपॉइंट: जिओलोकेशन-संचालित खोज

1) खोजें (पते जैसे स्थान द्वारा)

जब आपके पास शहर, काउंटी, पड़ोस, या ज़िप जैसे स्थान स्ट्रिंग हो तो इसका उपयोग करें।

विधि: GET
यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
आवश्यक पैरामीटर: स्थान (जैसे, "लॉस एंजेलेस, सीए")
वैकल्पिक पैरामीटर: पृष्ठ (जैसे, "2"), घर की स्थिति (जैसे, "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"

उदाहरण प्रतिक्रिया (आधिकारिक नमूना ब्लॉक फ़ील्ड में संक्षिप्त):

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

आप वास्तव में अधिकांश जिओलोकेशन प्रवाह में क्या उपयोग करेंगे:

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

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

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

विधि: GET
यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
आवश्यक पैरामीटर: लंबा, लैट
वैकल्पिक पैरामीटर: व्यास

cURL:

उदाहरण प्रतिक्रिया (आधिकारिक नमूना स्लाइस):

3) बहुभुज द्वारा खोजें (कस्टम-खींचा क्षेत्र)

जब मानचित्र पर खींचे गए जटिल या गैर-मानक आकारों के भीतर खोजने के लिए इसका उपयोग करें—जब एक सरल व्यास पर्याप्त सटीक नहीं होता है।

विधि: GET
यूआरएल: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
आवश्यक पैरामीटर: बहुभुज (स्पेस-सेपरेटेड lng lat जोड़े, कॉमा-सीमांकित)

cURL:

उदाहरण प्रतिक्रिया (आधिकारिक नमूना स्लाइस):

पायथन उदाहरण: पते द्वारा संपत्ति खोजें (जिओकोडेड लिस्टिंग डेटा)

यह न्यूनतम स्क्रिप्ट "लॉस एंजेलेस, सीए" के साथ खोज एंडपॉइंट को कॉल करती है और मुख्य जिओलोकेशन और मूल्य निर्धारण फ़ील्ड को प्रिंट करती है।

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=20)
resp.raise_for_status()
payload = resp.json()

print("Status:", payload.get("status"))
print("Request ID:", payload.get("request_id"))
print("Params echoed by API:", payload.get("parameters"))

for item in payload.get("data", []):
print("---")
print("zpid:", item.get("zpid"))
print("address:", item.get("address"))
print("city/state/zip:", item.get("city"), item.get("state"), item.get("zipcode"))
print("lat/long:", item.get("latitude"), item.get("longitude"))
print("homeType:", item.get("homeType"))
print("price:", item.get("price"), item.get("currency"))
print("beds/baths/area:", item.get("bedrooms"), item.get("bathrooms"), item.get("livingArea"))
print("detailUrl:", item.get("detailUrl"))

समय बचाने वाले व्यावहारिक नोट्स

प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
पृष्ठांकन: पृष्ठ एक स्ट्रिंग पैरामीटर है। परिणामों के माध्यम से पृष्ठांकन करने के लिए इसे बढ़ाएँ; एपीआई ट्रेसबिलिटी के लिए पैरामीटर में पृष्ठ मान को प्रतिध्वनित करता है।
समन्वय: अक्षांश/देशांतर दशमलव डिग्री हैं; वेब मानचित्रों पर सीधे प्रदर्शित करें। समन्वय खोज के लिए दूरी प्रदान किए गए व्यास पैरामीटर का उपयोग करती है।
मुद्रा: कीमत और मुद्रा लौटाई जाती है; उदाहरण यूएसडी दिखाते हैं। रूपांतरण का अनुमान न लगाएँ—प्रदान किए गए मूल्यों को प्रदर्शित करें।
फ़िल्टरिंग: home_status इन उदाहरणों में FOR_SALE जैसे मानों का समर्थन करता है। लौटाए गए फ़ील्ड के आधार पर आवश्यकतानुसार आगे क्लाइंट-साइड फ़िल्टरिंग लागू करें।
कैशिंग: कई स्थान प्रश्नों को स्थान+पृष्ठ कुंजी के पीछे कैश किया जा सकता है। जब आप home_status जैसे फ़िल्टर बदलते हैं या जब ताजगी महत्वपूर्ण होती है तो कैश को बस्ट करें।
छवियाँ: imgSrc उपलब्ध होने पर थंबनेल के लिए उपयोग किया जा सकता है।

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

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

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

यदि आप MCP-संगत क्लाइंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) का उपयोग करते हैं, तो आप ज़ाइला के MCP एंडपॉइंट के माध्यम से कॉल रूट कर सकते हैं और अपनी कुंजी प्रबंधन केंद्रीकृत रख सकते हैं। यहाँ MCP एंट्री पॉइंट देखें: MCP. अपने एजेंट को रियल-टाइम ज़िलो डेटा एपीआई के HTTPS एंडपॉइंट्स को ऊपर दिखाए गए अनुसार सक्रिय करने के लिए कॉन्फ़िगर करें, और अपने मानक प्रमाणीकरण हेडर को पास करें। यह एजेंट प्रवाह के लिए उपयोगी है जैसे "एक बहुभुज खींचें, फिर इसके भीतर शीर्ष 10 FOR_SALE लिस्टिंग का सारांश बनाएं।"

समस्या निवारण चेकलिस्ट

401 या 403 त्रुटियाँ: पुष्टि करें कि प्रमाणीकरण हेडर Bearer YOUR_API_KEY का उपयोग करता है और सदस्यता सक्रिय है।
कोई परिणाम नहीं: स्थान प्रारूप या बहुभुज समन्वय (lng lat क्रम, कॉमा-सीमांकित जोड़े, lng और lat के बीच स्थान) की पुष्टि करें।
मानचित्र ऑफसेट: सुनिश्चित करें कि आप आइटम-स्तरीय अक्षांश और देशांतर फ़ील्ड का उपयोग कर रहे हैं और शहर के केंद्रीय बिंदुओं का नहीं।
पृष्ठांकन अंतराल: सुनिश्चित करें कि आप पृष्ठ को एक स्ट्रिंग के रूप में बढ़ाते हैं और जब एक पृष्ठ एक खाली डेटा सरणी लौटाता है तो रुकते हैं।

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

क्या एपीआई प्रत्येक संपत्ति के लिए अक्षांश और देशांतर लौटाता है?
हाँ। लिस्टिंग में मानचित्रण और दूरी की गणनाओं के लिए उपयुक्त अक्षांश और देशांतर फ़ील्ड शामिल हैं।

मैं सटीक मानचित्र स्थान द्वारा कैसे खोजूं?
समन्वय द्वारा खोज का उपयोग करें जिसमें लंबा और लैट (और वैकल्पिक रूप से व्यास) हो ताकि एक बिंदु के पास संपत्तियों को क्वेरी किया जा सके।

क्या मैं उपयोगकर्ता द्वारा खींचे गए कस्टम आकार के भीतर खोज सकता हूँ?
हाँ। बहुभुज द्वारा खोज का उपयोग करें और lng lat समन्वय जोड़ों की एक बहुभुज स्ट्रिंग पास करें, जो कॉमा द्वारा अलग किए गए हैं।

मैं बड़े परिणाम सेट के माध्यम से पृष्ठांकन कैसे करूं?
पृष्ठ को एक पैरामीटर के रूप में पास करें। एपीआई पैरामीटर में पृष्ठ को वापस प्रतिध्वनित करता है ताकि आप ट्रैक कर सकें कि आप कहाँ हैं।

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

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