For developers
What you get
The same checks the extension and this site run. Send a claim or a passage; get back a verdict, the
official figure, the agency series it came from and a ready-made citation. Base address:
https://factcheckgov.app.
Check a passage
POST /v2/check takes up to 8,000 characters and answers each claim in it.
curl -s https://factcheckgov.app/v2/check \
-H 'Content-Type: application/json' \
-d '{"text": "Inflation hit 9.1% in June 2022. Gas averaged $7 a gallon in June 2022."}'
claims: one entry per claim, in order.spanis the claim as written,claimis what was checked,resultis the answer (the same object/v2/verifyreturns).tally: how many claims fell under each verdict.deeper: true when agency data did not settle a claim and the full check might. Send that claim to/v2/verify."mode": "page"keeps only the claims agency data can settle."said_on": "2012-02-08"is the day the text was said. A claim that names no period (“unemployment is 8.3%”) is then held to the figure that was newest that day. If it does not match, there is no verdict: the claim may be about another period.{"url": "https://..."}in place oftextfetches that public page and checks it as a page; the answer addspage(address, site, title, andpublished, the day the page says it came out). A month named without a year is read against that day, andinheritedon the claim says so. Sites that refuse automated readers answer400with the reason. Video and social media pages are not read.
One claim in the text gets the full check. Two or more are checked on agency data only.
Check one claim
POST /v2/verify takes {"claim": "..."}, up to 1,000 characters.
curl -s https://factcheckgov.app/v2/verify \
-H 'Content-Type: application/json' \
-d '{"claim": "Unemployment in Texas was 4.1% in 2023"}'
verdict: Supported, Mostly accurate, Contradicted, Misleading or No verdict.confidence: High, Medium or Low.reason: set when there is no verdict; says what would have to change for one to exist.evidence: the official figure, its period, place, agency, series and source address.revision: set when the claim matches a figure the agency has since revised.tierandmodel_calls: how the answer was reached. Most arestructuredwith zero model calls.display: the same answer in plain language, ready to show: the label, a summary, how the claim was read, the sources and a citation.
Look up a figure
POST /v2/lookup takes {"query": "unemployment rate texas 2023"} and returns the
figure with its citation in several forms. On a miss, suggestions names what it can fetch.
For assistants
POST /mcp speaks the Model Context Protocol (streamable HTTP), so an assistant that supports
it can check claims and look up figures as tools. It offers check_text,
check_page, check_claim and find_figure, all answered from agency
data only.
Limits and fair use
- Per connection: 20 claim checks a minute and 300 a day; 6 passage checks a minute and 60 a day;
60 lookups a minute and 2,000 a day. Over a limit, the answer is
429withRetry-After. - Calls from a web page in someone’s browser are not allowed (no cross-origin access). Call from your server.
- Answers come from agencies that revise their figures. Store the date with anything you keep.
- The service is free and comes with no guarantee of uptime. If you build something that depends on it, say hello first.
Source
The code is public at github.com/RadoKyselak/Stelthar-API. How a claim is judged is on the method page.