通过邮政编码获取犯罪率的API

您本周需要按邮政编码获取犯罪风险，而不是进行GIS的全面改革。在本指南结束时，您将查询一个端点，传递一个邮政编码，并获得整体犯罪等级以及暴力、财产和其他犯罪率的详细分类，您可以直接将其放入您的产品中。

通过邮政编码API获取的犯罪数据

通过邮政编码的犯罪数据API 返回给定美国邮政编码的JSON对象，包含：

整体犯罪等级以及暴力、财产和其他犯罪的单独等级。
类别级别的犯罪率（例如，攻击、抢劫、盗窃、车辆盗窃等）。
每个类别的总数和分数。
附近邮政编码及其等级。
具有相似人口的邮政编码及其等级。

常见用例包括房地产搜索叠加层、搬迁工具、送货服务风险过滤器和内部安全仪表板。您传递一个邮政编码，获得一致的、结构化的数据，您可以立即呈现。

在Zyla API Hub上开始

Zyla API Hub为您提供一个帐户、一个API密钥，以及一个跨越超过10,000个公共API的订阅+配额模型。要使用此API：

在Zyla API Hub上打开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
Auth：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 2Other2 Rate":"5.902","Total 2Other2 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…

从此有效负载中读取内容：

整体：使用整体犯罪等级和子等级为邮政编码徽章或风险计量器着色。
犯罪分类：读取类别率（例如，攻击、盗窃）及每个类别的总数和分数。
附近的犯罪率：提供具有其等级的替代邮政编码。
相似人口犯罪率：显示可比邮政编码的等级以供参考。

注意：数字率以字符串形式返回。如果您需要进行计算，请在代码中转换为数字。

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")
}

# 遍历犯罪分类以提取一些代表性率
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 = data.get("Crime Rates Nearby", [])[:3]
print("Nearby:", nearby)

节省时间的实施注意事项

身份验证：始终发送Authorization: Bearer YOUR_API_KEY。
输入：邮政编码是数字。确保您传递一个5位数的邮政编码。如果您的UI捕获邮政编码+4，请去掉后缀。
解析：像“攻击”、“盗窃”这样的字段是字符串。如果需要，转换为浮点数。
缓存：按邮政编码缓存，以避免在同一会话中重复查找。犯罪等级相对于请求频率变化缓慢，因此每日缓存通常足够。
后备：如果邮政编码缺失或返回不完整的分类，显示整体犯罪等级和附近邮政编码作为替代。
UI映射：将等级（A+到F）视为有序类别以进行颜色比例；除非您明确转换，否则不要假设线性数字比例。
错误：将非2xx响应与消息和邮政编码输入记录到您的日志中。为5位数的邮政编码添加客户端输入验证。

常见模式和用例

房地产搜索：在按房地产邮政编码键入的列表页面上显示整体犯罪等级徽章。
潜在客户资格：将来自低风险邮政编码的销售线索路由到优先队列。
物流：使用暴力和财产等级过滤交付窗口或添加司机警报。
保险报价：将类别总数（例如，车辆盗窃）纳入内部风险模型。
搬迁工具：建议具有更高等级的附近邮政编码作为替代。

通过MCP从AI代理调用API

如果您使用MCP兼容的客户端（例如，Claude Code、Cursor、Windsurf），则可以通过MCP网关调用Zyla API。将您的客户端指向MCP端点，并根据您的工具配置包含您的密钥。了解更多信息：MCP。

同一中心端点可以通过网关访问，因此唯一的变化是您的客户端如何路由请求并附加Authorization。请参考您的MCP客户端文档以获取工具配置和提示路由。

端到端接线检查清单

从Zyla API Hub的列表页面获取API密钥。
验证并将邮政编码规范化为5位数字字符串。
GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip，带有邮政编码和Bearer令牌。
立即呈现整体犯罪等级；如果您的UI需要详细分类，则延迟加载。
如果等级低于您的阈值，则使用附近的犯罪率提供替代选项。
按邮政编码缓存响应以减少延迟和调用。

常见问题解答

端点需要什么参数？
在查询字符串中传递邮政编码作为数字，例如，zip=01370。

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

API返回什么？
一个JSON对象，包含整体和类别犯罪等级、详细率、附近邮政编码等级和相似人口邮政编码等级。

数字率是数字还是字符串？
它们在有效负载中是字符串；在需要时在代码中转换为浮点数。

如何处理计费？
Zyla使用订阅+配额模型（而不是按调用计费）。请查看API页面以获取当前访问选项。您可以在列表页面开始7天的试用。

准备好集成了吗？在Zyla API Hub上创建您的帐户，获取您的密钥，并使用列表的端点发布您的按邮政编码的犯罪功能。从这里开始：通过邮政编码的犯罪数据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 2Other2 Rate":"5.902","Total 2Other2 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 2Other2 Rate":"5.902","Total 2Other2 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…