Relity API

Evidence, not verdicts — programmatically.

Send a claim, headline, or question; get Relity's evidence read back as JSON — the consensus badge, the reasoning, and where it appears. Pro members get an API key.

Endpoints

GET https://relity.ai/api/v1/hot — what’s hot on social right now (engagement-ranked, categorized, UNVERIFIED by construction — the noise bucket as JSON).
Header: Authorization: Bearer YOUR_KEY

POST https://relity.ai/api/v1/check
Header: Authorization: Bearer YOUR_KEY
Body: { "text": "..." }

Example

curl -X POST https://relity.ai/api/v1/check \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"the great wall of china is visible from space"}'

Response

JSON with read (badge · line · level — the evidence-weighed consensus), sources (where it appears), and shareUrl + shareText — a ready-to-share link back to the live check plus an honest caption, so your users can share the evidence. Rate limit: 120 requests / 10 minutes per key.

Evidence, not a verdict — the read is one input; you and your users make the call.