Method: claims.search
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-08 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-08 UTC."],[[["\u003cp\u003eSearch through fact-checked claims using a textual query or filter by review publisher.\u003c/p\u003e\n"],["\u003cp\u003eRefine your search by language, the age of claims, and pagination options for large result sets.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns a list of claims with associated information, including a token for retrieving further results.\u003c/p\u003e\n"],["\u003cp\u003eRequests are made using HTTP GET to the specified endpoint with query parameters for customization.\u003c/p\u003e\n"],["\u003cp\u003eResponses are provided in JSON format containing an array of claims and a pagination token.\u003c/p\u003e\n"]]],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FactCheckedClaimSearchResponse.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nSearch through fact-checked claims.\n\nHTTP request\n\n`GET https://factchecktools.googleapis.com/v1alpha1/claims:search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nQuery parameters\n\n| Parameters ||\n|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `string` Textual query string. Required unless `reviewPublisherSiteFilter` is specified. |\n| `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. |\n| `reviewPublisherSiteFilter` | `string` The review publisher site to filter results by, e.g. nytimes.com. |\n| `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. |\n| `pageSize` | `integer` The pagination size. We will return up to that many results. Defaults to 10 if not set. |\n| `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. |\n| `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. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Response from searching fact-checked claims.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"claims\": [ { object (/fact-check/tools/api/reference/rest/v1alpha1/claims#Claim) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `claims[]` | `object (`[Claim](/fact-check/tools/api/reference/rest/v1alpha1/claims#Claim)`)` The list of claims and all of their associated information. |\n| `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. |"]]