Mediastack API

⭐ Beginner's Pick News / API Key Intermediate HTTPS
Varies by plan (check documentation)

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

article title and content
publication source
published date
article URL
image URL

Example Response

JSON 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

101 - Missing Access Key The access_key parameter was not included in the request
Add ?access_key=YOUR_API_KEY to every request URL
104 - Usage Limit Reached Monthly request quota on the free plan has been exhausted
Wait until the next billing cycle or upgrade to a paid plan
HTTPS request fails on free tier The free plan does not support SSL/HTTPS endpoints
Use http:// instead of https:// for API calls on the free tier

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category News
Difficulty Intermediate
Verified: 2026-04-04

Alternatives to Mediastack

Technical alternatives for different use cases.

Free news API with keyword and region filtering

Better For

Free news aggregation for small projects

Trade-off

Premium source access and real-time delivery

Google News-sourced articles with topic and country filtering

Better For

Google News-quality article sourcing

Trade-off

Live news tickers and breaking news feeds

70K+ sources with powerful search and filtering

Better For

Comprehensive news search across many sources

Trade-off

Free production use (dev-only free tier)

Similar APIs

View All →