URLhaus

简介

URLhaus（abuse.ch 出品）追踪恶意 URL——恶意软件分发和钓鱼——提供 REST API 做查询和提交。

⚠️ 破坏性变更（2026-08 实测）：API 请求现在返回 HTTP 401 “Unauthorized”——API 需要 API 密钥（免密钥查询层已移除）。请在 urlhaus.abuse.ch 注册账号，使用个人资料里的密钥。

快速开始

在 urlhaus.abuse.ch 注册获取密钥，然后（替换 YOUR_KEY）：

curl "https://urlhaus-api.abuse.ch/v1/url/" \
  -H "Auth-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "http://example.com/malware.exe"}'

{
  "query_status": "no_results",
  "url": "http://example.com/malware.exe"
}

主机查询：

curl "https://urlhaus-api.abuse.ch/v1/host/" \
  -H "Auth-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host": "example.com"}'

认证方式

• 在 urlhaus.abuse.ch 注册 → API 密钥在个人资料页。
• 通过 Auth-Key 请求头携带（缺失/无效 → 401，已实测）。

速率限制与注意事项

• API 有按用户限流（见文档）——密钥免费。
• 端点：/v1/url/（URL 查询/提交）、/v1/host/、/v1/payload/、/v1/recent/。
• 响应里的 query_status 告诉你结果（“no_results”、“ok”、“url_recently_online”……）。
• 网站网页搜索对手动查询仍免费。

常见问题

URLhaus 免费吗？ API 免费但现在需要 API 密钥（无密钥 401，已实测）。

如何获取密钥？ 在 urlhaus.abuse.ch 注册——密钥在个人资料页。

可以查询什么？ URL、主机、载荷和最近新增。