Safe Browsing API

  • The Safe Browsing APIs enable client applications to cross-reference web resources, primarily URLs, with Google's lists of unsafe web resources for non-commercial use only.

  • Commercial users seeking malicious URL detection should utilize the Web Risk API instead of the Safe Browsing APIs.

  • The APIs offer various functionalities, including retrieving hash lists, searching for full hashes based on prefixes, and fetching recent threat list updates.

  • The service endpoint for accessing these APIs is https://safebrowsing.googleapis.com.

  • Multiple REST resources, such as v5alpha1.hashList, v5alpha1.hashLists, and v5alpha1.hashes, are available for interacting with the service.

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.hashList

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

REST Resource: v5.hashLists

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

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.