Overview
News API gives you access to breaking news headlines and articles from thousands of global news sources and blogs. It is perfect for building news aggregators, monitoring specific topics, or staying updated with live headlines. With a simple API key and a few lines of code, you can filter news by keyword, source, country, or language.
Beginner Tip
Start with the /v2/top-headlines endpoint to fetch current headlines — it requires just your API key and an optional country or category parameter. Free-tier requests are limited to 100 per day, so cache results when possible.
Available Data
Example Response
{
"totalArticles": 100,
"articles": [
{
"title": "Tech Industry Sees Record Growth",
"source": {
"name": "TechNews",
"url": "https://technews.com"
},
"publishedAt": "2025-01-15T08:00:00Z",
"description": "The technology sector reported unprecedented growth...",
"image": "https://example.com/article-image.jpg",
"url": "https://technews.com/article/123"
}
]
} Field Reference
status Whether the request succeeded ("ok") or failed ("error") totalResults Total number of articles matching your query articles[].title Headline text of the article articles[].url Direct URL to the full article articles[].publishedAt ISO 8601 timestamp when the article was published articles[].source.name Name of the news outlet that published the article Implementation Example
const url = "https://newsapi.org/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Partially tested on Apr 5, 2026
Technical Specifications
Alternatives to News
Technical alternatives for different use cases.
Free with no production restrictions
Budget-friendly news aggregation
Article quality and source reputation data
Google News-backed with free tier for production use
Production apps on free tier (News API restricts this)
Number of sources and search flexibility
Global coverage with pagination and source filtering
Paginated news feeds with language filtering
Advanced search operators and query syntax
Premium journalism API with article search and metadata
High-quality journalism and archive access
Multi-source news aggregation
Similar APIs
View All →Associated Press
The Associated Press Developer API gives you programmatic access to AP news content and metadata, one of the most trusted wire services in the world.
Currents
⭐ Beginner's PickCurrents API delivers the latest news from thousands of sources, blogs, and online forums in real time.
GNews
⭐ Beginner's PickGNews is a news search API that aggregates articles from thousands of sources worldwide and lets you filter by keyword, language, country, and topic.
MarketAux
MarketAux delivers real-time financial news with sentiment analysis, ticker tagging, and market statistics in a clean JSON format.
Mediastack
⭐ Beginner's PickMediastack is a simple REST API that delivers live and historical news articles from thousands of global sources.