如何使用按邮政编码划分的犯罪数据API

您需要在本周的应用程序中显示给定美国邮政编码的犯罪等级和类别细分。在本指南结束时，您将能够请求邮政编码的犯罪等级和比率，解析响应，并通过小型的、可投入生产的集成进行交付。

此API为您提供的内容

按邮政编码划分的犯罪数据API返回邮政编码的总体犯罪等级以及暴力、财产和其他犯罪类别的细分，以及附近邮政编码的比较和类似人口的邮政编码。它旨在用于房地产搜索、物流规划、保险风险筛查和本地仪表板等应用程序，其中需要按邮政编码快速获取犯罪概况。

此API可在 Zyla API Hub 上使用，这是一个拥有超过10,000个公共API的市场，所有API都在一个帐户、一个API密钥和一个订阅模型下。

在Zyla API Hub上开始

要使用此API：

打开Zyla API Hub上的API页面并订阅。
从仪表板复制您的API密钥。
使用Authorization: Bearer YOUR_API_KEY调用端点。

您可以在商品页面开始7天的试用。请查看API页面以获取当前访问选项和定价。计费是订阅+配额，而不是按调用计费。

开始7天试用按邮政编码划分的犯罪数据API

端点和请求

按邮政编码划分的犯罪数据API公开了一个关键端点，用于获取邮政编码的犯罪数据：

按邮政编码获取犯罪率
- 方法：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.Zipcode：查询的邮政编码。
Overall.Overall Crime Grade：单字母等级（例如，B）。
Overall.Violent Crime Grade、Property Crime Grade、Other Crime Grade：类别等级。
Crime BreakDown：特定类别的比率和总数（例如，攻击、盗窃、破坏）和汇总分数。
Crime Rates Nearby：附近邮政编码及其等级以供比较上下文。
Similar Population Crime Rates：具有相似人口的邮政编码及其等级。

注意事项：

字段名称包含空格（例如，“Overall Crime Grade”）。解析JSON时，按原样访问它们。
数字比率的单位是服务提供的每人口指标。除非您在整个UI中一致转换，否则按返回的方式显示它们。
如果您的工作负载重复查询相同的邮政编码，请添加客户端缓存以减少重复调用和延迟。

Python示例：获取邮政编码并提取等级

此示例调用端点，读取总体和类别等级，并总结附近的邮政编码。将YOUR_API_KEY替换为您的真实密钥。

import os
import requests

API_KEY = os.getenv("Zyla_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=15)
resp.raise_for_status()
data = resp.json()

overall = data.get("Overall", {})
overall_grade = overall.get("Overall Crime Grade")
violent_grade = overall.get("Violent Crime Grade")
property_grade = overall.get("Property Crime Grade")
other_grade = overall.get("Other Crime Grade")

print(f"ZIP {overall.get('Zipcode')}: overall {overall_grade}, "
f"violent {violent_grade}, property {property_grade}, other {other_grade}")

# 示例：提取攻击率和总财产犯罪（如果存在）
breakdown = data.get("Crime BreakDown", [])
for section in breakdown:
if "Violent Crime Rates" in section:
assault = section["Violent Crime Rates"].get("Assault")
print(f"攻击率：{assault}")
if "Property Crime Rates" in section:
total_prop = section.get("0", {}).get("Total Property Crime")
print(f"总财产犯罪：{total_prop}")

# 附近邮政编码等级预览
nearby = data.get("Crime Rates Nearby", [])
for n in nearby[:3]:
print(f"附近 {n.get('Nearby Zip')}: overall {n.get('Overall Crime Grade')}")

节省时间的实施细节

身份验证：在每个请求中使用Authorization: Bearer YOUR_API_KEY。
错误处理：将非2xx响应视为临时或无效输入（例如，格式错误或不支持的邮政编码）。记录状态代码和响应主体以进行故障排除。
超时：设置客户端超时（10-15秒是一个实用的默认值），并在网络故障时重试幂等的GET请求。
缓存：根据您的使用案例窗口按邮政编码缓存（例如，几小时到几天）。在后台作业中添加过期时重新验证的行为。
UI提示：
- 等级是基于字母的；提供图例以避免歧义（例如，A最好，F最差）。
- 在显示类别总数（例如，“总财产犯罪”）时，如果存在，请包含类别分数（例如，“（B）”）。
- 为了提供上下文，使用附近邮政编码的犯罪率添加“附近邮政编码”的比较视图。

您现在可以交付的实际用例

财产搜索：使用财产的邮政编码在每个列表卡上显示总体等级；在详细视图中扩展到类别细分。
搬迁工具：对于选择的邮政编码，获取等级和附近邮政编码以推荐更安全或可比较的社区。
最后一公里操作：按邮政编码计算风险评分以进行路线规划和交付时间窗口。
租户筛查门户：在租赁申请中添加上下文邮政编码风险面板。
保险预报价：在收集重个人信息的表单之前，显示位置风险提示。

通过MCP从AI代理调用API

您可以通过Zyla的模型上下文协议（MCP）网关从兼容的AI代理和IDE调用此相同的端点。MCP标准化了对Claude Code、Cursor和Windsurf等工具的API访问。将您的客户端指向MCP端点，使用您的Zyla API密钥进行授权，并调用该工具，该工具向按邮政编码划分的犯罪数据API URL发出GET请求，并带有zip参数。

文档和连接细节： MCP。使用相同的Authorization: Bearer YOUR_API_KEY，并保留上述描述的确切请求URL和参数。

操作检查清单

输入：验证邮政编码为5位数字字符串；在调用之前拒绝或清理非数字字符。
可观察性：记录请求ID、邮政编码、状态代码和最小响应元数据（例如，总体等级）以用于支持仪表板。
退避：在临时错误或速率响应时，应用指数退避和抖动；在UI中显示后备消息。
安全性：将API密钥保存在服务器端秘密中；绝不要在客户端代码中暴露它。
数据刷新：如果您定期同步流行的邮政编码，请运行一个计划作业来预热您的缓存，以减少感知延迟。

端到端流程摘要

用户选择一个邮政编码，或者您从地址地理编码器推断出它。
您的后端调用GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip，带有zip=XXXXX和Authorization: Bearer YOUR_API_KEY。
解析您需要的JSON字段：
- 顶层UI的总体等级。
- 工具提示和详细面板的犯罪细分。
- 推荐的附近邮政编码。
按邮政编码缓存响应；按您的计划过期。
在您的UI中呈现等级和比率；可选地添加链接以比较附近的邮政编码。

常见问题解答

需要什么参数？
在查询字符串中传递zip作为数字（示例：zip=01370）。

我如何进行身份验证？
在请求头中发送Authorization: Bearer YOUR_API_KEY。

我可以获得附近邮政编码的比较吗？
是的。响应包括附近邮政编码的犯罪率及其等级。

定价模型是什么？
Zyla APIs使用订阅+配额。请查看API页面以获取当前访问选项；7天的试用在商品页面开始。

我可以从AI代理调用这个吗？
是的，通过Zyla的MCP网关在兼容的工具中。使用相同的Authorization头和文档化的URL及zip参数。

准备好集成了吗？在 Zyla API Hub 上创建您的帐户，获取您的API密钥，并在此处开始您的试用：按邮政编码划分的犯罪数据API。一个帐户，一个密钥，数千个您可以在本周交付的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…