Build on 1,300+ fact-checked claims.

Authentication

Every request needs an Authorization header with your Bearer token. Keys look like tk_live_xxxxxxxxxxxxxxxx.

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxx

Rate limits

Every response includes X-RateLimit-Remaining and X-RateLimit-Reset. Over-limit requests return 429 with a Retry-After header.

Endpoints

Examples

cURL

curl https://theyknew.io/api/v1/claims?limit=5 \
  -H "Authorization: Bearer tk_live_your_key_here"

JavaScript (fetch)

const res = await fetch("https://theyknew.io/api/v1/claims?category=intelligence", {
  headers: { Authorization: "Bearer tk_live_your_key_here" }
});
const { data, meta } = await res.json();

Python (requests)

import requests

r = requests.get(
    "https://theyknew.io/api/v1/claims",
    headers={"Authorization": "Bearer tk_live_your_key_here"},
    params={"q": "epstein", "limit": 20},
)
print(r.json())

Response format

All responses use a stable envelope: { data, meta, error }. Dates are ISO 8601 UTC. Errors return an error.code and error.message.

{
  "data": [
    {
      "id": 123,
      "slug": "cia-mkultra",
      "title": "The CIA ran MK-ULTRA mind-control experiments",
      "status": "VERIFIED",
      "vote_count": 842,
      "url": "https://theyknew.io/claims/cia-mkultra"
    }
  ],
  "meta": { "total": 1321, "page": 1, "limit": 20, "has_next": true }
}