REST Resource: claims

  • This documentation details the Claim, ClaimReview, and Publisher objects, and their JSON representations, for use with the Fact Check Tools API.

  • A Claim object stores information about a claim, such as the claim text, claimant, date, and any associated ClaimReview objects.

  • A ClaimReview object represents a fact-checking article that reviews a claim, and includes details like the publisher, URL, and review rating.

  • A Publisher object stores information about the publisher of a claim review, such as their name and website.

  • The Fact Check Tools API provides methods to search through claims using text or images.

Resource: Claim

Information about the claim.

JSON representation 
{
  "text": string,
  "claimant": string,
  "claimDate": string,
  "claimReview": [
    {
      object (ClaimReview)
    }
  ]
}
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".
claimDate

string (Timestamp format)

The date that the claim was made.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
claimReview[]

object (ClaimReview)

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

ClaimReview

Information about a claim review.

JSON representation 
{
  "publisher": {
    object (Publisher)
  },
  "url": string,
  "title": string,
  "reviewDate": string,
  "textualRating": string,
  "languageCode": string
}
Fields
publisher

object (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.
reviewDate

string (Timestamp format)

The date the claim was reviewed.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
textualRating

string

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

string

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

Publisher

Information about the publisher.

JSON representation 
{
  "name": string,
  "site": string
}
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.

Methods

imageSearch

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