Safe Browsing API

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

  • For commercial purposes, including "for sale or revenue-generating purposes," the Web Risk API should be used instead of the Safe Browsing APIs.

  • Developers need the service name safebrowsing.googleapis.com for creating RPC client stubs when interacting with the API.

  • The Safe Browsing APIs offer various functionalities such as fetching threat list updates, finding full hashes and threat matches, listing available threat lists, searching for specific hashes, and managing hash lists.

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

The Service name safebrowsing.googleapis.com is needed to create RPC client stubs.

google.security.safebrowsing.v4.SafeBrowsing

Methods
FetchThreatListUpdates Fetches the most recent threat list updates.
FindFullHashes Finds the full hashes that match the requested hash prefixes.
FindThreatMatches Finds the threat entries that match the Safe Browsing lists.
ListThreatLists Lists the Safe Browsing threat lists available for download.

google.security.safebrowsing.v5.SafeBrowsing

Methods
BatchGetHashLists Get multiple hash lists at once.
GetHashList Get the latest contents of a hash list.
ListHashLists List hash lists.
SearchHashes Search for full hashes matching the specified prefixes.

google.security.safebrowsing.v5alpha1.SafeBrowsing

Methods
BatchGetHashLists Get multiple hash lists at once.
GetHashList Get the latest contents of a hash list.
ListHashLists List hash lists.
SearchHashes Search for full hashes matching the specified prefixes.