如何按邮政编码获取犯罪率

您需要显示给定美国邮政编码的犯罪等级和按犯罪类型的细分，本周将其集成到您的应用程序中，然后继续。通过本指南的结束，您将获取任何邮政编码的整体犯罪等级以及暴力/财产/其他组成部分，并将其放入仪表板、列表页面或风险模型中，只需一次 GET 请求。

您可以用单个邮政编码构建的内容

按邮政编码获取犯罪数据 API 返回您传入的邮政编码的紧凑 JSON 报告。您将获得：

整体犯罪等级（字母等级）
暴力、财产和其他犯罪的细分，包括总数和每类比率
附近邮政编码的比较和相似人口邮政编码的比较

团队将其集成到房地产列表、搬迁工具、承保原型和城市数据仪表板中。您传入一个邮政编码，您将获得一个分数和可以立即呈现的细分。

在 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 托管超过 10,000 个公共 API，涵盖金融、丰富、人工智能、地理定位、电子商务和公用事业。浏览目录 zylalabs.com，并在列表中重用相同的密钥。

您将使用的端点

此 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.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 中提取附近邮政编码列表以进行上下文比较。

Python 示例：获取和规范等级

此最小脚本调用相同的端点，解析等级，并扁平化总数以进行呈现。在运行之前将 YOUR_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 参数在列表中是数字。如果您接受带有前导零的用户输入，请规范化为数字或传递用户输入的确切数字。
缓存：犯罪等级不会每分钟变化。按邮政编码缓存以减少高流量页面上的重复调用。
呈现：等级是字母字符串，如 A、A-、B、…、F。保留原始字符串；除非您的模型需要，否则不要强制转换为数字。
细分：响应包括在每个细分对象内部名为 "0" 的键下的总数。提取这些以进行快速摘要。
比较：Crime Rates Nearby 数组非常适合用于带有简单徽章的邻近邮政编码的侧边栏列表。相似人口比较也是如此。

现实世界的用例

房地产列表页面：显示“整体犯罪等级”，并展开详细信息抽屉，显示暴力/财产/其他总数。
搬迁计算器：输入邮政编码并显示附近邮政编码的更好或更差的等级，来自 Crime Rates Nearby。
路由和交付规划：标记具有较低等级的仓库或服务区域并直接采取缓解措施。
承保原型：将潜在客户的邮政编码映射到风险桶，使用整体等级和暴力总数。
市民仪表板：将多个邮政编码结果汇总到一个市政面板中，并突出显示异常值。

通过 MCP 从 AI 代理调用 API

如果您使用兼容 MCP 的客户端（例如，Claude Code、Cursor、Windsurf）自动化任务，您可以将此相同的端点暴露给您的代理。配置您的客户端以使用 Zyla 的 MCP 端点，并包含您的 Zyla API 密钥。代理将执行相同的 GET 请求，带有 Authorization 头，并返回您上面看到的 JSON。

MCP 端点： MCP
密钥处理：重用您的 Zyla API 密钥；将其作用域设置为代理的环境变量。
工具：让您的代理接受邮政编码参数，并将其映射到中心 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
您可能会使用的响应字段：整体等级、来自 Crime BreakDown 的总数、附近邮政编码

浏览更多类别，或将此与 Zyla API Hub 上的映射、地理编码或人口统计配对，使用相同的密钥和订阅模型。

常见问题解答

接受哪些邮政编码格式？
将数字邮政编码作为 zip 查询参数传递（例如，01370）。如果您的应用程序收集 ZIP+4，请去掉扩展名并发送 5 位邮政编码。

我如何进行身份验证？
在每个请求中包含头 Authorization: Bearer YOUR_API_KEY。

我可以进行批量请求吗？
列出的端点每次接受一个邮政编码。对于批量处理，循环遍历邮政编码并进行基本并发处理并缓存结果。

这些等级代表什么？
字母等级按类别总结犯罪水平。使用“整体犯罪等级”作为单个徽章，使用类别等级作为详细信息。响应还包括各种比率和总数的数字字符串。

是否有免费计划？
Zyla 使用订阅 + 配额。对于您的第一个 API，您可以在可用时开始 7 天试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。

准备好发布这个了吗？订阅并在列表中获取您的密钥：在按邮政编码获取犯罪数据 API 上开始 7 天试用。在 Zyla 上的数千个其他 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…