ZIP द्वारा अपराध दर प्राप्त करने के लिए API

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

ZIP कोड API द्वारा अपराध डेटा से आपको क्या मिलता है

ZIP कोड द्वारा अपराध डेटा API एक दिए गए अमेरिकी ZIP कोड के लिए एक JSON ऑब्जेक्ट लौटाता है जिसमें:

समग्र अपराध ग्रेड और हिंसक, संपत्ति, और अन्य अपराध के लिए अलग-अलग ग्रेड।
श्रेणी-स्तरीय अपराध दरें (जैसे, हमला, डकैती, चोरी, वाहन चोरी, आदि)।
प्रत्येक श्रेणी के लिए कुल और स्कोर।
उनके ग्रेड के साथ निकटवर्ती ZIP।
समान जनसंख्या वाले ZIP और उनके ग्रेड।

सामान्य उपयोग के मामलों में संपत्ति खोज ओवरले, पुनर्वास उपकरण, डिलीवरी-सेवा जोखिम फ़िल्टर, और आंतरिक सुरक्षा डैशबोर्ड शामिल हैं। आप एक ZIP पास करते हैं और आपको लगातार, संरचित डेटा मिलता है जिसे आप तुरंत प्रदर्शित कर सकते हैं।

Zyla API हब पर शुरू करना

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

Zyla API हब पर API पृष्ठ खोलें।
लिस्टिंग पृष्ठ पर, अपनी कुंजी प्राप्त करने के लिए सब्सक्राइब या फ्री ट्रायल शुरू करें (जब उपलब्ध हो)।
Authorization: Bearer YOUR_API_KEY के साथ एंडपॉइंट को कॉल करें।

आप लिस्टिंग से सीधे 7-दिन का ट्रायल शुरू कर सकते हैं: ZIP कोड द्वारा अपराध डेटा API पर 7-दिन का ट्रायल शुरू करें. वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

आप जो एंडपॉइंट उपयोग करेंगे

यह API एक एकल, डेवलपर-फ्रेंडली एंडपॉइंट को उजागर करता है।

नाम: ZIP द्वारा अपराध दर प्राप्त करें
विधि: GET
URL: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
आवश्यक क्वेरी पैरामीटर: zip (संख्या)। उदाहरण: 01370
प्रमाणन: Authorization: Bearer YOUR_API_KEY

curl के साथ त्वरित परीक्षण

कॉपी/पेस्ट करें और YOUR_API_KEY को अपनी कुंजी से बदलें:

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…

इस पेलोड से क्या पढ़ें:

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

नोट: संख्यात्मक दरें स्ट्रिंग के रूप में लौटाई जाती हैं। यदि आपको उनके साथ गणना करने की आवश्यकता है तो अपने कोड में संख्याओं में परिवर्तित करें।

Python उदाहरण: ग्रेड और प्रमुख दरें प्राप्त करें

यह उदाहरण उसी एंडपॉइंट को कॉल करता है, JSON को पार्स करता है, और ग्रेड और कुछ दर मान निकालता है। YOUR_API_KEY को अपनी कुंजी से बदलें।

import os
import requests

API_KEY = os.getenv("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"
resp = requests.get(url, params={"zip": ZIP}, headers={"Authorization": f"Bearer {API_KEY}"}, 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")
}

# Traverse Crime BreakDown to extract a few representative rates
assault = robbery = theft = None
for section in data.get("Crime BreakDown", []):
if "Violent Crime Rates" in section:
v = section["Violent Crime Rates"]
assault = float(v.get("Assault")) if v.get("Assault") is not None else None
robbery = float(v.get("Robbery")) if v.get("Robbery") is not None else None
if "Property Crime Rates" in section:
p = section["Property Crime Rates"]
theft = float(p.get("Theft")) if p.get("Theft") is not None else None

print("Grades:", grades)
print("Key rates:", {"Assault": assault, "Robbery": robbery, "Theft": theft})

# Nearby ZIPs list (first three)
nearby = data.get("Crime Rates Nearby", [])[:3]
print("Nearby:", nearby)

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

प्रमाणन: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
इनपुट: zip संख्यात्मक है। सुनिश्चित करें कि आप 5-अंकीय ZIP पास करते हैं। यदि आपका UI ZIP+4 कैप्चर करता है, तो उपसर्ग को हटा दें।
पार्सिंग: "Assault", "Theft" जैसे फ़ील्ड स्ट्रिंग हैं। यदि आवश्यक हो तो float में परिवर्तित करें।
कैशिंग: एक ही सत्र में दोहराए गए लुकअप से बचने के लिए ZIP द्वारा कैश करें। अपराध ग्रेड अनुरोध की आवृत्ति के सापेक्ष धीरे-धीरे बदलते हैं, इसलिए दैनिक कैश आमतौर पर पर्याप्त होता है।
फॉलबैक: यदि कोई ZIP गायब है या अधूरा ब्रेकडाउन लौटाता है, तो वैकल्पिक के रूप में समग्र अपराध ग्रेड और निकटवर्ती ZIP प्रदर्शित करें।
UI मैपिंग: ग्रेड (A+ से F) को रंग पैमाने के लिए क्रमबद्ध श्रेणियों के रूप में मानें; जब तक आप स्पष्ट रूप से परिवर्तित नहीं करते, तब तक एक रैखिक संख्यात्मक पैमाने का अनुमान न लगाएं।
त्रुटियाँ: अपने लॉग में संदेश और ZIP इनपुट के साथ गैर-2xx प्रतिक्रियाओं को सतह पर लाएं। 5-अंकीय ZIP के लिए क्लाइंट-साइड इनपुट मान्यता जोड़ें।

सामान्य पैटर्न और उपयोग के मामले

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

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

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

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

एंड-टू-एंड वायरिंग चेकलिस्ट

Zyla API हब पर लिस्टिंग पृष्ठ से एक API कुंजी प्राप्त करें।
ZIP को 5-अंकीय संख्यात्मक स्ट्रिंग में मान्य और सामान्य करें।
GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip के साथ zip और Bearer टोकन।
तुरंत समग्र अपराध ग्रेड प्रदर्शित करें; यदि आपका UI उन्हें आवश्यक है तो विस्तृत ब्रेकडाउन को लेज़ी-लोड करें।
यदि ग्रेड आपके थ्रेशोल्ड से नीचे है तो अपराध दरों के निकटवर्ती विकल्पों की पेशकश करें।
लेटेंसी और कॉल को कम करने के लिए प्रत्येक ZIP के लिए प्रतिक्रियाओं को कैश करें।

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

एंडपॉइंट को कौन सा पैरामीटर चाहिए?
क्वेरी स्ट्रिंग में zip को एक संख्या के रूप में पास करें, जैसे, zip=01370।

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

API क्या लौटाता है?
एक JSON ऑब्जेक्ट जिसमें समग्र और श्रेणी अपराध ग्रेड, विस्तृत दरें, निकटवर्ती ZIP ग्रेड, और समान जनसंख्या ZIP ग्रेड शामिल हैं।

क्या संख्यात्मक दरें संख्याएँ हैं या स्ट्रिंग?
ये पेलोड में स्ट्रिंग हैं; जब आवश्यक हो तो अपने कोड में float में कास्ट करें।

बिलिंग कैसे संभाली जाती है?
Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। वर्तमान पहुंच विकल्पों के लिए API पृष्ठ की जांच करें। आप लिस्टिंग पृष्ठ पर 7-दिन का ट्रायल शुरू कर सकते हैं।

इंटीग्रेट करने के लिए तैयार हैं? Zyla API हब पर अपना खाता बनाएं, अपनी कुंजी प्राप्त करें, और लिस्टिंग के एंडपॉइंट का उपयोग करके अपने अपराध-के-ZIP फीचर को शिप करें। यहां से शुरू करें: ZIP कोड द्वारा अपराध डेटा API.

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