Try any of 817 endpoints — live.
Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.
Editor-curated top headlines by Google-News topic section (WORLD/BUSINESS/TECHNOLOGY/…) and/or country edition. De-duplicated. The 'front page' call.
Google-News topic section for top_headlines. Hard enum (the section feeds are a fixed set). Combine with country for a localized edition.
Restrict to a source country (GDELT FIPS country code, e.g. US, UK, FR, IN, BR). Omit for global. For top_headlines this is the Google-News edition.
Max articles to fetch per source before de-dup (1-250, default 50). Larger values are clamped to 250 (GDELT ceiling). (1–250)
Collapse the same story from many outlets (exact-url + host+path + near-duplicate title clustering). Default true. Survivors carry duplicate_count + also_reported_by[]. Set false for the raw firehose.
curl -X POST https://api.reefapi.com/news-intel/v1/top_headlines \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"topic":"TECHNOLOGY"}'Hit Send to run this endpoint live.