Package google.factchecking.factchecktools.v1alpha1

Index

FactCheckToolsService

Fact Check Tools API

The Fact Check Tools API provides programmatic access to the functionality provided through the Google Fact Check Tools frontend at https://g.co/factchecktools.

The current APIs available are:

  • Fact Checked Claim Search (provided through the Fact Check Explorer frontend).
  • Fact Checked Claim Search by Image (provided through the Fact Check Explorer frontend).

  • CRUD interface for ClaimReview markup on a page (provided through the Fact Check Markup Tool frontend).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Create ClaimReview markup on a page.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/factchecktools
DeleteClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Delete all ClaimReview markup on a page.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/factchecktools
FactCheckedClaimImageSearch

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Search through fact-checked claims using an image as the query.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Search through fact-checked claims.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Get all ClaimReview markup on a page.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/factchecktools
ListClaimReviewMarkupPages

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

List the ClaimReview markup pages for a specific URL or for an organization.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/factchecktools
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Update for all ClaimReview markup on a page

Note that this is a full update. To retain the existing ClaimReview markup on a page, first perform a Get operation, then modify the returned markup, and finally call Update with the entire ClaimReview markup as the body.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/factchecktools

Claim

Information about the claim.

Fields
text

string

The claim text. For instance, "Crime has doubled in the last 2 years."
claimant

string

A person or organization stating the claim. For instance, "John Doe".
claim_date

Timestamp

The date that the claim was made.
claim_review[]

ClaimReview

One or more reviews of this claim (namely, a fact-checking article).

ClaimAuthor

Information about the claim author.

Fields
name

string

A person or organization stating the claim. For instance, "John Doe".
Corresponds to ClaimReview.itemReviewed.author.name.
job_title

string

Corresponds to ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Corresponds to ClaimReview.itemReviewed.author.image.
same_as

string

Corresponds to ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Information about the claim rating.

Fields
textual_rating

string

The truthfulness rating as a human-readible short word or phrase.
Corresponds to ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

A numeric rating of this claim, in the range worstRating — bestRating inclusive.
Corresponds to ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

For numeric ratings, the worst value possible in the scale from worst to best.
Corresponds to ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

For numeric ratings, the best value possible in the scale from worst to best.
Corresponds to ClaimReview.reviewRating.bestRating.
rating_explanation

string

Corresponds to ClaimReview.reviewRating.ratingExplanation.
image_url

string

Corresponds to ClaimReview.reviewRating.image.

ClaimReview

Information about a claim review.

Fields
publisher

Publisher

The publisher of this claim review.
url

string

The URL of this claim review.
title

string

The title of this claim review, if it can be determined.
review_date

Timestamp

The date the claim was reviewed.
textual_rating

string

Textual rating. For instance, "Mostly false".
language_code

string

The language this review was written in. For instance, "en" or "de".

ClaimReviewAuthor

Information about the claim review author.

Fields
name

string

Name of the organization that is publishing the fact check.
Corresponds to ClaimReview.author.name.
image_url

string

Corresponds to ClaimReview.author.image.

ClaimReviewMarkup

Fields for an individual ClaimReview element. Except for sub-messages that group fields together, each of these fields correspond those in https://schema.org/ClaimReview. We list the precise mapping for each field.

Fields
url

string

This field is optional, and will default to the page URL. We provide this field to allow you the override the default value, but the only permitted override is the page URL plus an optional anchor link ("page jump").
Corresponds to ClaimReview.url
claim_reviewed

string

A short summary of the claim being evaluated.
Corresponds to ClaimReview.claimReviewed.
claim_date

string

The date when the claim was made or entered public discourse.
Corresponds to ClaimReview.itemReviewed.datePublished.
claim_location

string

The location where this claim was made.
Corresponds to ClaimReview.itemReviewed.name.
claim_first_appearance

string

A link to a work in which this claim first appears.
Corresponds to ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

A list of links to works in which this claim appears, aside from the one specified in claim_first_appearance.
Corresponds to ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Info about the author of this claim.
rating

ClaimRating

Info about the rating of this claim review.

ClaimReviewMarkupPage

Holds one or more instances of ClaimReview markup for a webpage.

Fields
name

string

The name of this ClaimReview markup page resource, in the form of pages/{page_id}. Except for update requests, this field is output-only and should not be set by the user.
page_url

string

The URL of the page associated with this ClaimReview markup. While every individual ClaimReview has its own URL field, semantically this is a page-level field, and each ClaimReview on this page will use this value unless individually overridden.
Corresponds to ClaimReview.url
publish_date

string

The date when the fact check was published. Similar to the URL, semantically this is a page-level field, and each ClaimReview on this page will contain the same value.
Corresponds to ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Info about the author of this claim review. Similar to the above, semantically these are page-level fields, and each ClaimReview on this page will contain the same values.
claim_review_markups[]

ClaimReviewMarkup

A list of individual claim reviews for this page. Each item in the list corresponds to one ClaimReview element.
version_id

string

The version ID for this markup. Except for update requests, this field is output-only and should not be set by the user.

CreateClaimReviewMarkupPageRequest

Request for creating ClaimReview markup on a page.

Fields
claim_review_markup_page

ClaimReviewMarkupPage

The ClaimReview markup to create for this page. If there is a more canonical version of the page URL provided, we will use that one instead.

DeleteClaimReviewMarkupPageRequest

Request for deleting all ClaimReview markup on a page.

Fields
name

string

The name of the resource to delete, in the form of pages/{page_id}.

FactCheckedClaimImageSearchRequest

Request for searching through fact-checked claims by image.

Fields
image_uri

string

Required. The URI of the source image. This must be a publicly-accessible image HTTP/HTTPS URL.

When fetching images from HTTP/HTTPS URLs, Google cannot guarantee that the request will be completed. Your request may fail if the specified host denies the request (e.g. due to request throttling or DOS prevention), or if Google throttles requests to the site for abuse prevention. You should not depend on externally-hosted images for production applications.
language_code

string

Optional. 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.
page_size

int32

Optional. The pagination size. We will return up to that many results. Defaults to 10 if not set.
page_token

string

Optional. The pagination token. You may provide the next_page_token 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

int32

Optional. An integer that specifies the current offset (that is, starting result location) in search results. This field is only considered if page_token is unset. For example, 0 means to return results starting from the first matching result, and 10 means to return from the 11th result.

FactCheckedClaimImageSearchResponse

Response from searching fact-checked claims by image.

Fields
results[]

Result

The list of claims and all of their associated information.
next_page_token

string

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

Result

A claim and its associated information.

Fields
claim

Claim

A claim which matched the query.

FactCheckedClaimSearchRequest

Request for searching through fact-checked claims.

Fields
query

string

Textual query string. Required unless review_publisher_site_filter is specified.
language_code

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.
review_publisher_site_filter

string

The review publisher site to filter results by, e.g. nytimes.com.
max_age_days

int32

The maximum age of the returned search results, in days. Age is determined by either claim date or review date, whichever is newer.
page_size

int32

The pagination size. We will return up to that many results. Defaults to 10 if not set.
page_token

string

The pagination token. You may provide the next_page_token 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

int32

An integer that specifies the current offset (that is, starting result location) in search results. This field is only considered if page_token is unset. For example, 0 means to return results starting from the first matching result, and 10 means to return from the 11th result.

FactCheckedClaimSearchResponse

Response from searching fact-checked claims.

Fields
claims[]

Claim

The list of claims and all of their associated information.
next_page_token

string

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

GetClaimReviewMarkupPageRequest

Request for getting the ClaimReview markup on a page.

Fields
name

string

The name of the resource to get, in the form of pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Request for listing ClaimReview markup.

Fields
url

string

The URL from which to get ClaimReview markup. There will be at most one result. If markup is associated with a more canonical version of the URL provided, we will return that URL instead. Cannot be specified along with an organization.
organization

string

The organization for which we want to fetch markups for. For instance, "site.com". Cannot be specified along with an URL.
page_size

int32

The pagination size. We will return up to that many results. Defaults to 10 if not set. Has no effect if a URL is requested.
page_token

string

The pagination token. You may provide the next_page_token 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

int32

An integer that specifies the current offset (that is, starting result location) in search results. This field is only considered if page_token is unset, and if the request is not for a specific URL. For example, 0 means to return results starting from the first matching result, and 10 means to return from the 11th result.

ListClaimReviewMarkupPagesResponse

Response from listing ClaimReview markup.

Fields
claim_review_markup_pages[]

ClaimReviewMarkupPage

The result list of pages of ClaimReview markup.
next_page_token

string

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

Publisher

Information about the publisher.

Fields
name

string

The name of this publisher. For instance, "Awesome Fact Checks".
site

string

Host-level site name, without the protocol or "www" prefix. For instance, "awesomefactchecks.com". This value of this field is based purely on the claim review URL.

UpdateClaimReviewMarkupPageRequest

Request for updating all ClaimReview markup on a page.

Fields
claim_review_markup_page

ClaimReviewMarkupPage

The updated ClaimReview markup for this page. Update requests must specify both the resource name and version ID of the resource to update. If the specified version ID does not match the version ID of the latest markup (which may happen if the markup has been modified since last read), this request will fail. Updates must also not change the page URL. To change the URL of the markup, delete the old markup and recreate it with the new URL.