Every API, one clean contract.

Global news search across GDELT (+ optionally merged Google-News-RSS), de-duplicated into one unified article shape. The core 'what's the news on X' call. Filter by timespan/language/country/sort; each article carries title, url, source_domain, published_at, language, snippet, image, duplicate_count, also_reported_by[].

{
  "query": "OpenAI",
  "timespan": "2d",
  "max": 40
}

How much is X in the news over time — GDELT volume-over-time (timelinevol) for a query as [{date, value}], with peak detection (max point + average + latest).

{
  "query": "earthquake",
  "timespan": "1w"
}

What's big in the news right now — a curated multi-bucket roll-up (breaking/world/tech/business/politics/science by default, or your own queries) ranked by recent volume, each with a few representative headlines.

{
  "timespan": "1d"
}

Editor-curated top headlines by Google-News topic section (WORLD/BUSINESS/TECHNOLOGY/…) and/or country edition. De-duplicated. The 'front page' call.

{
  "topic": "TECHNOLOGY"
}

Recent articles from a specific publisher domain (reuters.com, bbc.com, …). Google-News site:<domain> is the reliable primary (near-live, ~100% on-source); GDELT domain:<domain> enriches with direct publisher URLs + tone when its 5s window is free (skipped silently otherwise — never blocks). Source-exact. merge_google_news=false → GDELT-only exact.

{
  "source": "reuters.com",
  "timespan": "3d"
}

Full-story coverage — for a story/topic, which outlets are covering it. Returns the most-covered stories first, each expanded to every outlet that carried it (outlet_count + outlets[]). The story→outlets roll-up for media-monitoring / PR (how widely was X reported, and by whom). Parity with Real-Time-News-Data /full-story-coverage.

{
  "query": "OpenAI",
  "timespan": "3d"
}

Reference / discovery directory — supported outlets (filterable by category/country) plus the topic, language and country reference lists. Parity with newsdata/NewsAPI/mediastack /sources and RTND /language-list. Note: by_source accepts ANY domain, so this is a curated starting set, not a whitelist. Static (no fetch, no proxy hop).

Hacker News tech vertical — top/new/best stories, or a full-text Algolia search. Each story: title, url, points, author, num_comments, created_at, hn_url.

{
  "list": "top",
  "max": 20
}

Run up to 10 search queries in one call (shared concurrency, GDELT 5s-window paced). results[] preserves input order; each is a de-duped search result.

{
  "queries": "openai,tesla,bitcoin",
  "timespan": "2d",
  "max": 20
}