Google Safe Browsing

简介

Google Safe Browsing 让你对照 Google 的恶意软件/钓鱼黑名单检查 URL。认证是 Google API 密钥。

注（2026-08 实测）：v4 端点（/v4/threatMatches:find）在我们测试中返回 HTTP 404——Google 已迁移到 Safe Browsing v5（API 密钥可用 key 查询参数传递，或端点迁到 /v5/）。请查阅当前文档（developers.google.com/safe-browsing）了解 v5 迁移。

快速开始

V5 风格（替换 YOUR_KEY）：

curl "https://safebrowsing.googleapis.com/v5/threatMatches:find?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client": { "clientId": "your-app", "clientVersion": "1.0" },
    "threatInfo": {
      "threatTypes": ["MALWARE", "SOCIAL_ENGINEERING"],
      "platformTypes": ["ANY_PLATFORM"],
      "threatEntryTypes": ["URL"],
      "threatEntries": [{ "url": "http://example.com/malware.exe" }]
    }
  }'

{
  "matches": [
    { "threatType": "MALWARE", "platformType": "ANY_PLATFORM", "threat": { "url": "http://example.com/malware.exe" } }
  ]
}

认证方式

• 在 Google Cloud Console 获取密钥 → APIs & Services → 启用 Safe Browsing API。
• 通过 key 查询参数携带。

速率限制与注意事项

• 免费层：宽裕的每日配额（看控制台）；超出后计费。
• 威胁类型：MALWARE、SOCIAL_ENGINEERING、UNWANTED_SOFTWARE、POTENTIALLY_HARMFUL_APPLICATION。
• v5 是当前 API——v4 端点可能 404（2026-08 实测）。

常见问题

Safe Browsing 免费吗？ 免费层带每日配额；更多需要计费。

为什么 v4 404？ Google 已迁移到 Safe Browsing v5（已实测）——请用 /v5/ 路径。

如何获取密钥？ Google Cloud Console → 启用 Safe Browsing API。