On September 30, 2024 the Fact Check Tools API will require users to update their OAuth tokens to include the FCT scope 'https://www.googleapis.com/auth/factchecktools'. This update to comply with best practices means you will need to make a change in order to continue using RPCs which use OAuth tokens for authentication. For instructions on how to set or change the scope, you can check the documentation for the use of OAuth 2.0 to access Google APIs. Note: RPCs which currently use API keys for authentication will not be affected. If you have any questions, please contact us at fct-api@google.com.

Method: claims.search

HTTP request
Query parameters
Request body
Response body
- JSON representation
Try it!

Search through fact-checked claims.

HTTP request

GET https://factchecktools.googleapis.com/v1alpha1/claims:search

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
`query`	`string` Textual query string. Required unless `reviewPublisherSiteFilter` is specified.
`languageCode`	`string` The BCP-47 language code, such as "en-US" or "sr-Latn". Can be used to restrict results by language, though we do not currently consider the region.
`reviewPublisherSiteFilter`	`string` The review publisher site to filter results by, e.g. nytimes.com.
`maxAgeDays`	`integer` The maximum age of the returned search results, in days. Age is determined by either claim date or review date, whichever is newer.
`pageSize`	`integer` The pagination size. We will return up to that many results. Defaults to 10 if not set.
`pageToken`	`string` The pagination token. You may provide the `nextPageToken` returned from a previous List request, if any, in order to get the next page. All other fields must have the same values as in the previous request.
`offset`	`integer` An integer that specifies the current offset (that is, starting result location) in search results. This field is only considered if `pageToken` is unset. For example, 0 means to return results starting from the first matching result, and 10 means to return from the 11th result.

Request body

The request body must be empty.

Response body

Response from searching fact-checked claims.

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

JSON representation
{ "claims": [ { object (`Claim`) } ], "nextPageToken": string }

Fields

Fields
`claims[]`	`object (Claim)` The list of claims and all of their associated information.
`nextPageToken`	`string` The next pagination token in the Search response. It should be used as the `pageToken` for the following request. An empty value means no more results.

claims[]

object (Claim)

The list of claims and all of their associated information.

nextPageToken

string

The next pagination token in the Search response. It should be used as the pageToken for the following request. An empty value means no more results.