Mediastack API
Overview
Mediastack is a simple REST API that delivers live and historical news articles from thousands of global sources. It is easy to integrate and returns clean JSON, making it ideal for your first news aggregation project. The free tier allows up to 500 requests per month with no credit card required.
Beginner Tip
Use the languages and countries parameters to narrow results to your target audience right from the start. The free plan only supports HTTP, so do not worry if HTTPS requests fail on the basic tier.
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
data Array of news article objects returned by the query data[].title Headline of the news article data[].url Direct link to the full news article data[].source Name of the publication or news source data[].published_at ISO 8601 timestamp of when the article was published pagination.total Total number of articles matching the query across all pages Implementation Example
const url = "https://mediastack.com/";
// 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 Mediastack
Technical alternatives for different use cases.
Free news API with keyword and region filtering
Free news aggregation for small projects
Premium source access and real-time delivery
Google News-sourced articles with topic and country filtering
Google News-quality article sourcing
Live news tickers and breaking news feeds
70K+ sources with powerful search and filtering
Comprehensive news search across many sources
Free production use (dev-only free tier)
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.
New York Times
⭐ Beginner's PickThe New York Times API gives developers access to articles, book reviews, movie reviews, bestseller lists, and more from one of the most prestigious news organizations in the world.