Method: threatMatches.find

Page Summary

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.

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

The URL uses gRPC Transcoding syntax.

The request body contains data with the following structure:

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

Fields

Fields
`client`	`object ( ClientInfo )` The client metadata.
`threatInfo`	`object ( ThreatInfo )` The lists and entries to be checked for matches.

client

object ( ClientInfo )

The client metadata.

threatInfo

object ( ThreatInfo )

The lists and entries to be checked for matches.

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

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

Fields

Fields
`matches[]`	`object ( ThreatMatch )` The threat list matches.

matches[]

object ( ThreatMatch )

The threat list matches.