Method: threatLists.list

  • This API lists the Safe Browsing threat lists available for download.

  • It uses a GET request to https://safebrowsing.googleapis.com/v4/threatLists with an empty request body.

  • The response provides a list of ThreatListDescriptor objects, each describing a threat list with its type, platform, and entry type.

  • Each ThreatListDescriptor helps identify the specific threats, platforms affected, and the kind of entries within each list.

Lists the Safe Browsing threat lists available for download.

HTTP request

GET https://safebrowsing.googleapis.com/v4/threatLists

The URL uses gRPC Transcoding syntax.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "threatLists": [
    {
      object (ThreatListDescriptor)
    }
  ]
}
Fields
threatLists[]

object (ThreatListDescriptor)

The lists available for download by the client.

ThreatListDescriptor

Describes an individual threat list. A list is defined by three parameters: the type of threat posed, the type of platform targeted by the threat, and the type of entries in the list.

JSON representation 
{
  "threatType": enum (ThreatType),
  "platformType": enum (PlatformType),
  "threatEntryType": enum (ThreatEntryType)
}
Fields
threatType

enum (ThreatType)

The threat type posed by the list's entries.
platformType

enum (PlatformType)

The platform type targeted by the list's entries.
threatEntryType

enum (ThreatEntryType)

The entry types contained in the list.