आपको एक दिए गए अमेरिकी ZIP कोड के लिए अपराध ग्रेड और अपराध के प्रकार के अनुसार विभाजन प्रदर्शित करने की आवश्यकता है, इसे इस सप्ताह अपने ऐप में जोड़ें, और आगे बढ़ें। इस गाइड के अंत तक आप किसी भी ZIP के लिए एक समग्र अपराध ग्रेड के साथ-साथ हिंसक/संपत्ति/अन्य घटकों को प्राप्त करेंगे, और इसे एक डैशबोर्ड, लिस्टिंग पृष्ठ, या जोखिम मॉडल में एकल GET अनुरोध के साथ डालेंगे।
एकल ZIP के साथ आप क्या बना सकते हैं
क्राइम डेटा बाय ज़िपकोड API उस ZIP के लिए एक संक्षिप्त JSON रिपोर्ट लौटाता है जिसे आप पास करते हैं। आपको मिलेगा:
- समग्र अपराध ग्रेड (पत्र ग्रेड)
- हिंसक, संपत्ति, और अन्य अपराधों के लिए विभाजन जिसमें कुल और प्रति श्रेणी दरें शामिल हैं
- नजदीकी ZIP की तुलना और समान जनसंख्या ZIP की तुलना
टीम इसको रियल एस्टेट लिस्टिंग, पुनर्वास उपकरण, अंडरराइटिंग प्रोटोटाइप, और शहर डेटा डैशबोर्ड में जोड़ती हैं। आप एक ZIP पास करते हैं, आपको एक स्कोर और विभाजन मिलता है जिसे आप तुरंत प्रदर्शित कर सकते हैं।
Zyla API Hub पर शुरू करना
Zyla API Hub पर API की लिस्टिंग खोलें और API कुंजी प्राप्त करने के लिए सब्सक्राइब करें। Zyla एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। आपके पहले API के लिए, आप उपलब्धता के आधार पर 7-दिन की परीक्षण अवधि या 50 अनुरोध शुरू कर सकते हैं—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
- API पृष्ठ पर जाएं: क्राइम डेटा बाय ज़िपकोड API पर 7-दिन की परीक्षण अवधि शुरू करें
- उपलब्ध होने पर सब्सक्राइब या फ्री ट्रायल शुरू करें पर क्लिक करें।
- अपने खाते से अपनी API कुंजी कॉपी करें। प्रमाणीकरण एक HTTP हेडर है: Authorization: Bearer YOUR_API_KEY।
Zyla API Hub वित्त, समृद्धि, AI, भू-स्थान, ई-कॉमर्स, और उपयोगिताओं के तहत 10,000 से अधिक सार्वजनिक APIs की मेज़बानी करता है। zylalabs.com पर कैटलॉग ब्राउज़ करें और लिस्टिंग में अपनी वही कुंजी पुनः उपयोग करें।
आप जो एंडपॉइंट उपयोग करेंगे
इस API का एक ही काम है: एक दिए गए ZIP कोड के लिए अपराध ग्रेड और दरें लौटाना।
- एंडपॉइंट: ZIP द्वारा अपराध दरें प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
- आवश्यक क्वेरी पैरामीटर: zip (संख्या)। उदाहरण: 01370
cURL उदाहरण (कॉपी/पेस्ट)
curl -s -X GET "https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip?zip=01370" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक नमूना प्रतिक्रिया
{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}} ,{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}} ,{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total \"Other\" Rate":"5.902","Total \"Other\" Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…
डेवलपर्स आमतौर पर जो निकालते हैं:
Overall.Overall Crime Gradeएक एकल-पत्र बैज (A+ से F) के लिए।Overall.Violent Crime Grade,Overall.Property Crime Grade,Overall.Other Crime Gradeउप-स्कोर के लिए।Crime BreakDownएरे से कुल (जैसे,Total Violent Crime,Total Property Crime,Total "Other" Rate)।- संदर्भ तुलना के लिए
Crime Rates Nearbyसे नजदीकी ZIP सूची।
Python उदाहरण: ग्रेड प्राप्त करें और सामान्यीकृत करें
यह न्यूनतम स्क्रिप्ट उसी एंडपॉइंट को कॉल करती है, ग्रेड को पार्स करती है, और रेंडरिंग के लिए कुल को समतल करती है। चलाने से पहले अपने API_KEY को एक पर्यावरण चर में स्टोर करें।
import os
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY") # स्थानीय परीक्षण में बदलें
ZIP = "01370"
url = "https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip"
params = {"zip": ZIP}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
overall = data.get("Overall", {})
grades = {
"zip": overall.get("Zipcode"),
"overall": overall.get("Overall Crime Grade"),
"violent": overall.get("Violent Crime Grade"),
"property": overall.get("Property Crime Grade"),
"other": overall.get("Other Crime Grade"),
}
# Crime BreakDown से कुल निकालें
totals = {}
for section in data.get("Crime BreakDown", []):
# प्रत्येक अनुभाग में कुल के साथ "0" कुंजी होती है; जो उपलब्ध है उसे रखें
totals.update(section.get("0", {}))
nearby = [
{
"zip": item.get("Nearby Zip"),
"overall": item.get("Overall Crime Grade"),
"violent": item.get("Violent Crime Grade"),
"property": item.get("Property Crime Grade"),
}
for item in data.get("Crime Rates Nearby", [])
]
print("Grades:", grades)
print("Totals:", totals)
print("Nearby (first 3):", nearby[:3])
समय बचाने वाले कार्यान्वयन नोट्स
- प्रमाणीकरण: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
- पैरामीटर प्रकार:
zipपैरामीटर लिस्टिंग में संख्यात्मक है। यदि आप अग्रणी शून्य के साथ उपयोगकर्ता इनपुट स्वीकार करते हैं, तो इसे संख्यात्मक में सामान्यीकृत करें या उपयोगकर्ता द्वारा दर्ज किए गए सटीक अंकों को पास करें। - कैशिंग: अपराध ग्रेड मिनट दर मिनट नहीं बदलते। उच्च-ट्रैफ़िक पृष्ठों पर दोहराए गए कॉल को कम करने के लिए ZIP द्वारा कैश करें।
- रेंडरिंग: ग्रेड पत्र स्ट्रिंग होते हैं जैसे A, A-, B, …, F। मूल स्ट्रिंग को बनाए रखें; जब तक आपका मॉडल इसकी आवश्यकता न हो, तब तक संख्याओं में परिवर्तित न करें।
- विभाजन: प्रतिक्रिया में प्रत्येक विभाजन वस्तु के अंदर एक कुंजी नामित
"0"के तहत कुल शामिल होते हैं। त्वरित सारांश के लिए उन्हें बाहर निकालें। - तुलनाएँ:
Crime Rates Nearbyएरे पड़ोसी ZIP के सरल बैज के लिए आदर्श है। समान जनसंख्या की तुलना के लिए भी यही।
वास्तविक दुनिया के उपयोग के मामले
- संपत्ति लिस्टिंग पृष्ठ: "समग्र अपराध ग्रेड" दिखाएं और हिंसक/संपत्ति/अन्य कुल के साथ विवरण दराज का विस्तार करें।
- पुनर्वास कैलकुलेटर: एक ZIP इनपुट करें और
Crime Rates Nearbyसे बेहतर या खराब ग्रेड के साथ नजदीकी ZIP दिखाएं। - रूटिंग और डिलीवरी योजना: कम ग्रेड वाले डिपो या सेवा क्षेत्रों को चिह्नित करें और शमन कदमों को निर्देशित करें।
- अंडरराइटिंग प्रोटोटाइप: समग्र ग्रेड और हिंसक कुल का उपयोग करके एक संभावित ग्राहक के ZIP को एक जोखिम बकेट से मैप करें।
- सिविक डैशबोर्ड: कई ZIP परिणामों को एक नगरपालिका पैनल में समेकित करें और बाहरी लोगों को उजागर करें।
MCP के माध्यम से AI एजेंटों से API कॉल करना
यदि आप MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) के साथ कार्यों को स्वचालित करते हैं, तो आप अपने एजेंट के लिए इसी एंडपॉइंट को उजागर कर सकते हैं। अपने क्लाइंट को Zyla के MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें और अपनी Zyla API कुंजी शामिल करें। एजेंट वही GET अनुरोध करेगा, Authorization हेडर के साथ, और आपको ऊपर देखी गई JSON लौटाएगा।
- MCP एंडपॉइंट: MCP
- कुंजी प्रबंधन: अपनी Zyla API कुंजी का पुनः उपयोग करें; इसे अपने एजेंट के पर्यावरण चर पर स्कोप करें।
- उपकरण: अपने एजेंट को एक ZIP तर्क स्वीकार करने दें और इसे हब URL पर क्वेरी पैरामीटर
zipसे मैप करें।
यह आपके प्रॉम्प्ट को साफ रखता है और आपके एजेंट को कोडिंग या डेटा-समृद्धि सत्र के दौरान मांग पर अपराध ग्रेड प्राप्त करने की अनुमति देता है।
त्वरित संदर्भ
- बेस हब एंडपॉइंट: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
- विधि: GET
- आवश्यक पैरामीटर: zip (संख्या)
- प्रमाणन हेडर: Authorization: Bearer YOUR_API_KEY
- प्रतिक्रिया फ़ील्ड जिनका आप likely उपयोग करेंगे: समग्र ग्रेड, क्राइम ब्रेकडाउन से कुल, नजदीकी ZIP
अधिक श्रेणियों को ब्राउज़ करें या इसे Zyla API Hub पर मैपिंग, भू-कोडिंग, या जनसांख्यिकी के साथ जोड़ें, उसी कुंजी और सब्सक्रिप्शन मॉडल का उपयोग करते हुए।
अक्सर पूछे जाने वाले प्रश्न
कौन से ZIP प्रारूप स्वीकार किए जाते हैं?
संख्यात्मक ZIP कोड को zip क्वेरी पैरामीटर के रूप में पास करें (जैसे, 01370)। यदि आपका ऐप ZIP+4 एकत्र करता है, तो एक्सटेंशन को हटा दें और 5-अंकीय ZIP भेजें।
मैं प्रमाणीकरण कैसे करूं?
प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY हेडर शामिल करें।
क्या मैं बैच अनुरोध कर सकता हूँ?
लिस्टेड एंडपॉइंट प्रति कॉल एक ZIP स्वीकार करता है। थोक प्रसंस्करण के लिए, बुनियादी समवर्तीता के साथ ZIP पर लूप करें और परिणामों को कैश करें।
ग्रेड क्या दर्शाते हैं?
पत्र ग्रेड श्रेणी के अनुसार अपराध स्तरों का सारांश देते हैं। एक एकल बैज के लिए "समग्र अपराध ग्रेड" का उपयोग करें और विवरण के लिए श्रेणी ग्रेड का उपयोग करें। प्रतिक्रिया में विभिन्न दरों और कुल के लिए संख्यात्मक स्ट्रिंग भी शामिल हैं।
क्या कोई मुफ्त योजना है?
Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। आपके पहले API के लिए, आप उपलब्ध होने पर 7-दिन की परीक्षण अवधि या 50 अनुरोध शुरू कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या आप इसे भेजने के लिए तैयार हैं? लिस्टिंग पर सब्सक्राइब करें और अपनी कुंजी प्राप्त करें: क्राइम डेटा बाय ज़िपकोड API पर 7-दिन की परीक्षण अवधि शुरू करें. Zyla पर हजारों अन्य APIs में एक ही खाता और कुंजी का उपयोग करें।
आधिकारिक API प्रतिक्रिया
{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}},{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}},{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total Other Rate":"5.902","Total Other Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…
आधिकारिक API प्रतिक्रिया
{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}},{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}},{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total Other Rate":"5.902","Total Other Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…