The playground

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.

Playground demo key · api.reefapi.com

post/news-intel/v1/sources1 credit

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).

Parameters

categoryoptional

Optional filter for the sources directory by section (WORLD/BUSINESS/TECHNOLOGY/SPORTS/ENTERTAINMENT/SCIENCE/HEALTH/NATION).

countryoptional

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.

request preview

curl -X POST https://api.reefapi.com/news-intel/v1/sources \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Hit Send to run this endpoint live.