Method: threatLists.list

Page Summary

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.

HTTP request
Request body
Response body
- JSON representation
ThreatListDescriptor
- JSON representation

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

Fields
`threatLists[]`	`object ( ThreatListDescriptor )` The lists available for download by the client.

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

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.

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.

Method: threatLists.list Stay organized with collections Save and categorize content based on your preferences.