shipapis
StarSubmit an APISubmit API

NewsAPI

Headlines from 80k+ sources

📚 Open DataON SCHEDULE
AUTH APIKEYCORS ✗AGENT ?HTTPS ✓COMMERCIAL ?

NewsAPI aggregates headlines and articles worldwide. Free developer key at newsapi.org — 100 req/day on free tier.

—REACHABILITY SCORE ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: — · unmonitored
ON PROBE SCHEDULE

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass. Open provider docs ↗

Uptime historystarts after first probe

On our probe schedule. Uptime charts appear after the first check lands.

Example responsefrom provider docs — not verified by us
GET https://newsapi.org/top-headlines?country=us&pageSize=1&apiKey=YOUR_API_KEY

{
  "status": "error",
  "code": "apiKeyInvalid",
  "message": "Your API key is invalid or incorrect. Check your key, or go to https://newsapi.org to create a free API key."
}
Call itcurl · fetch · python
curl "https://newsapi.org/top-headlines?country=us&pageSize=1&apiKey=YOUR_API_KEY"
const res = await fetch("https://newsapi.org/top-headlines?country=us&pageSize=1&apiKey=YOUR_API_KEY");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://newsapi.org/top-headlines?country=us&pageSize=1&apiKey=YOUR_API_KEY")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 3On scheduleFULL DOCS ↗
On schedule — auth-wall reachability checks pending
GET/top-headlines?country=us&pageSize=1&apiKey=YOUR_API_KEYPROBED

Headlines from 80k+ sources

GET/top-headlines?limit=5

Top Headlines — documented GET route.

GET/top-headlines?page=1

Top Headlines — documented GET route.

Machine-readable spec

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass. Export includes every documented route below.

Response-shape history

Not tracked yet. Shape-change history starts once this API joins our probe schedule.

NewsAPI: common questions

Is NewsAPI free to use?

Yes — NewsAPI is a free open data API. Free tier: Free tier — API key required. Whether the free tier allows commercial use is unclear — check the provider docs.

Does NewsAPI need an API key?

Yes — NewsAPI needs a free API key, which you pass on each request. Rate limits: Unpublished.

Can I call NewsAPI from the browser?

Not directly — NewsAPI doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is NewsAPI up right now?

NewsAPI is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.