Anti-Malware — entry 004 of 15
Google Safe Browsing
Google Safe Browsing lets clients check URLs against Google's continuously updated lists of malware, phishing, and unwanted-software sites via the v4 threatMatches:find endpoint, the same data that powers warnings in Chrome and Search. A live POST with a syntactically valid but bogus key returned a 400 "API key not valid" error from safebrowsing.googleapis.com, reconfirming API-key auth and HTTPS, and both that call and its OPTIONS preflight echoed the request Origin in Access-Control-Allow-Origin. The API is free for any Google Cloud project under its published quota.
GreatAPIs Score
Auth quickstart
- Get a key at the provider
- Send it on every request as a query param
?key=<key>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
encodedFullHashes1
GET/v4/encodedFullHashes/{encodedRequest}
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
encodedRequest | path | yes | string |
clientId | query | no | string |
clientVersion | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4FindFullHashesResponse |
encodedUpdates1
GET/v4/encodedUpdates/{encodedRequest}
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
encodedRequest | path | yes | string |
clientId | query | no | string |
clientVersion | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse |
fullHashes1
POST/v4/fullHashes:find
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
application/json — GoogleSecuritySafebrowsingV4FindFullHashesRequest
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4FindFullHashesResponse |
threatHits1
POST/v4/threatHits
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
application/json — GoogleSecuritySafebrowsingV4ThreatHit
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleProtobufEmpty |
threatLists1
GET/v4/threatLists
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4ListThreatListsResponse |
threatListUpdates1
POST/v4/threatListUpdates:fetch
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
application/json — GoogleSecuritySafebrowsingV4FetchThreatListUpdatesRequest
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4FetchThreatListUpdatesResponse |
threatMatches1
POST/v4/threatMatches:find
| Name | In | Required | Type |
|---|---|---|---|
$.xgafv | query | no | string |
access_token | query | no | string |
alt | query | no | string |
callback | query | no | string |
fields | query | no | string |
key | query | no | string |
oauth_token | query | no | string |
prettyPrint | query | no | boolean |
quotaUser | query | no | string |
upload_protocol | query | no | string |
uploadType | query | no | string |
application/json — GoogleSecuritySafebrowsingV4FindThreatMatchesRequest
| Status | Description | Schema |
|---|---|---|
200 | Successful response | GoogleSecuritySafebrowsingV4FindThreatMatchesResponse |
Try it
Developer reference
Changelog
- gained a docs link, an OpenAPI spec and a pricing page