Safe Browsing API

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

Service: safebrowsing.googleapis.com

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://safebrowsing.googleapis.com

REST Resource: v5alpha1.hashList

Methods
get GET /v5alpha1/hashList/{name}
Get the latest contents of a hash list.

REST Resource: v5alpha1.hashLists

Methods
batchGet GET /v5alpha1/hashLists:batchGet
Get multiple hash lists at once.
list GET /v5alpha1/hashLists
List hash lists.

REST Resource: v5alpha1.hashes

Methods
search GET /v5alpha1/hashes:search
Search for full hashes matching the specified prefixes.

REST Resource: v5.hashes

Methods
search GET /v5/hashes:search
Search for full hashes matching the specified prefixes.

REST Resource: v4.fullHashes

Methods
find POST /v4/fullHashes:find
Finds the full hashes that match the requested hash prefixes.

REST Resource: v4.threatListUpdates

Methods
fetch POST /v4/threatListUpdates:fetch
Fetches the most recent threat list updates.

REST Resource: v4.threatLists

Methods
list GET /v4/threatLists
Lists the Safe Browsing threat lists available for download.

REST Resource: v4.threatMatches

Methods
find POST /v4/threatMatches:find
Finds the threat entries that match the Safe Browsing lists.