Skip to main content
POST
/
v2
/
fact-checker
cURL
curl --request POST \
  --url https://api.gowinston.ai/v2/fact-checker \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "text": "<string>",
  "file": "<string>",
  "website": "<string>",
  "language": "auto"
}'
{
  "status": 200,
  "claims": [
    {
      "id": 1,
      "sentence": "<string>",
      "claim": "<string>",
      "verdict": "SUPPORTED",
      "score": 100,
      "explanation": "<string>",
      "links": [
        {
          "url": "<string>",
          "title": "<string>"
        }
      ]
    }
  ],
  "score": 100,
  "claimsCount": 11,
  "text": "<string>",
  "sentences": [
    {
      "id": 1,
      "text": "<string>"
    }
  ],
  "input": "<string>",
  "language": "en",
  "creditsUsed": 1234,
  "creditsRemaining": 34567,
  "wordCount": 617
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The Fact Checker request body

​
text
string
required

The text to scan. It is required except if you supply a website or a file. Minimum 300 characters. Maximum 10,000 characters per request.

​
file
string

A publicly accessible URL to a file to scan. The file must be publicly available online (not a local file path) so our API can access it. The file must be in plain .pdf, .doc or .docx format. The file has priority over the text, so if you give a text and a file, it's the file that will be scanned.

​
website
string

A website URL to scan. If you supply a website, the API will fetch the content of the website and scan it. The website must be publicly accessible. It's important to know that the website has priority over the text and the file, so if you give a text, a file and a website, it's the website that will be scanned.

​
language
string
default:auto

2 letter language code. Default: auto.

If you put 'auto', the API will automatically detect the language based on the text.

Supported languages:

Arabic (ar), Bengali (bn), Bulgarian (bg), Chinese simplified and traditional (zh), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), English (en), Estonian (et), Finnish (fi), French (fr), German (de), Greek (el), Hebrew (he), Hindi (hi), Hungarian (hu), Indonesian (id), Italian (it), Japanese (ja), Korean (ko), Latvian (lv), Lithuanian (lt), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Serbian (sr), Slovak (sk), Slovenian (sl), Spanish (es), Swahili (sw), Swedish (sv), Thai (th), Turkish (tr), Ukrainian (uk), Vietnamese (vi).

Response

Fact Checker response

​
status
integer

HTTP status code for the response

Example:

200

​
claims
object[]

List of claims detected in the text along with their fact-checking results.

​
score
integer

Overall confidence score (0-100) that the provided text is accurate.

Example:

100

​
claimsCount
integer

Total number of claims extracted from the text. Maximum 12 per request.

Example:

11

​
text
string

The full original text that was analyzed.

​
sentences
object[]

List of sentences from the analyzed text, with IDs for mapping claims to the sentences.

​
input
string

Indicates the input type, e.g., 'text', 'file', or 'website'.

​
language
string

Detected or specified input language (2 letter code).

Example:

"en"

​
creditsUsed
integer

The number of credits used to process this request.

Example:

1234

​
creditsRemaining
integer

The number of remaining credits for the account.

Example:

34567

​
wordCount
integer

Word count of the input text.

Example:

617