The verified-feed API.

Our verification work, as data. A read-only JSON feed of stories that cleared the verification gate and the adversarial critic — each carrying the claim we verified, its corroboration tier, an honest confidence band, the caveats, and the source links.

AUTHENTICATION

Every request needs an API key, sent as a bearer token (or an X-API-Key header). Request a key →

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://reallygood.news/api/v1/stories?tier=corroborated&limit=20"

ENDPOINTS

GET /api/v1/stories

Published stories, newest first. Query parameters:

tier: corroborated (2+ independent outlets) or single; omit for both.
category: comma-separated: health, climate, conservation, science, rights, economy, connection.
min_confidence: 0–1 floor on the verification confidence score.
limit: 1–100 (default 25).
before: Pagination cursor — pass back the response's next_before to fetch the next page.

GET /api/v1/stories/:id

A single story by id.

RESPONSE

{
  "version": "v1",
  "count": 1,
  "next_before": "2026-06-27T00:00:00.000Z",
  "methodology": "https://reallygood.news/methodology",
  "stories": [
    {
      "id": "…",
      "url": "https://reallygood.news/item/…",
      "headline": "Solar outproduced coal on the national grid for a full quarter",
      "summary": "Grid-operator data show solar supplied more electricity than coal …",
      "why_it_matters": "Displacing coal at grid scale is the central task of decarbonizing electricity …",
      "category": "climate",
      "published_at": "2026-06-27T00:00:00.000Z",
      "claim": "Solar generation exceeded coal across one quarter on the national grid serving ~60M people.",
      "confidence": { "band": "well_substantiated", "label": "Well substantiated", "score": 0.86 },
      "corroboration": { "tier": "corroborated", "independent_sources": 3 },
      "scale": "≈60M people",
      "caveats": "Single quarter; winter output typically lower.",
      "sources": ["https://…", "https://…"]
    }
  ]
}

NOTES

Single-source stories are included and labelled "tier": "single" — filter with tier=corroborated for corroborated developments only. The confidence.score is a judgement, not a measurement; the methodology defines the bands. Rate limit: 60 requests per minute per key.

THE FIREWALL, AS A SERVICE

← How we verify