Method: threatMatches.find

  • This API endpoint allows you to find threat entries that match Safe Browsing lists using an HTTP POST request.

  • The request body requires client metadata and information about the threats to be checked, sent as a JSON object.

  • A successful response returns a JSON object containing a list of any matches found in the Safe Browsing lists.

  • You can find details about the request and response structures by referencing ClientInfo, ThreatInfo, and ThreatMatch in the provided documentation links.

Finds the threat entries that match the Safe Browsing lists.

HTTP request

POST https://safebrowsing.googleapis.com/v4/threatMatches:find

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "client": {
    object (ClientInfo)
  },
  "threatInfo": {
    object (ThreatInfo)
  }
}
Fields
client

object (ClientInfo)

The client metadata.
threatInfo

object (ThreatInfo)

The lists and entries to be checked for matches.

Response body

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

JSON representation 
{
  "matches": [
    {
      object (ThreatMatch)
    }
  ]
}
Fields
matches[]

object (ThreatMatch)

The threat list matches.