Mediastack

Mediastack is a free and paid REST API by apilayer for live, historical, and blog news articles aggregated from more than 7,500 publishers across 50+ countries and 13 languages. It exposes a /v1/news endpoint for keyword-, source-, country-, language-, category-, and date-filtered search, and a /v1/sources endpoint for browsing the underlying publisher catalog.

1 APIs 10 Features

NewsNews AggregationMediaApilayerPublic APIs

APIs

Mediastack News API

Live, historical, and blog news search plus publisher source discovery. Returns JSON with a pagination + data envelope, secured by an access_key query parameter.

Collections

Mediastack News API

OPEN

Pricing Plans

Mediastack Plans Pricing

5 plans

PLANS

Rate Limits

Mediastack Rate Limits

8 limits

RATE LIMITS

FinOps

Mediastack Finops

FINOPS

Features

Live News Data

Real-time aggregation of articles from 7,500+ global news publishers.

Historical News

Date-bounded lookups of past articles via the date query parameter (paid plans).

Multi-Language Coverage

Articles indexed across 13 languages including English, German, Spanish, French, Chinese, and Arabic.

Multi-Country Coverage

Filter by 50+ country codes using ISO 3166-1 alpha-2.

Category Filtering

Restrict to general, business, entertainment, health, science, sports, or technology.

Source Filtering

Include/exclude lists of specific publishers via comma-separated IDs.

Keyword Search

Full-text search across article title, description, and body.

Publisher Catalog

Browse the /sources catalog by country, language, or category.

HTTPS Encryption

Encrypted transport on Standard plan and above.

Commercial Use License

Permitted on Standard plan and above.

Use Cases

News Aggregator Apps

Power consumer-facing news readers with category- and language-filtered feeds.

Media Monitoring

Track brand, executive, product, or competitor mentions across global press.

Investor Research

Stream business-tagged headlines into trading dashboards.

AI Training Corpora

Sample current-events text for fine-tuning and retrieval-augmented generation.

Trend Analysis

Tally publication volume and sentiment around recurring keywords.

Newsletter Curation

Auto-generate daily digests by country, language, or topic.

Integrations

apilayer Marketplace

Mediastack is one of several APIs in the apilayer marketplace alongside marketstack, currencylayer, weatherstack, and ipapi.

REST + JSON

Standard HTTPS+JSON makes it trivial to integrate with any HTTP client library.

Postman / Insomnia

Manual import of the OpenAPI spec into common API clients.

Solutions

Free Plan

Evaluation tier, 100 requests/month, HTTP only, no historical data, no commercial use.

Standard Plan

$24.99/month, 10k requests, HTTPS, historical data, commercial use.

Professional Plan

$99.99/month, 50k requests, lower overage rate.

Business Plan

$249.99/month, 250k requests, lowest published overage rate.

Enterprise Plan

Custom volume, platinum support, custom solutions.

PublicAPIsListing

Sources

opencollection: 1.0.0
info:
  name: Mediastack News API
  version: 1.0.0
request:
  auth:
    type: apikey
    key: access_key
    value: '{{access_key}}'
    placement: query
items:
- info:
    name: News
    type: folder
  items:
  - info:
      name: Search Live News Articles
      type: http
    http:
      method: GET
      url: https://api.mediastack.com/v1/news
      params:
      - name: access_key
        value: ''
        type: query
        description: Mediastack API access key.
      - name: sources
        value: cnn,bbc,-techcrunch
        type: query
        description: Comma-separated list of source identifiers to include or exclude (prefix with `-` to exclude).
      - name: categories
        value: business,technology
        type: query
        description: Comma-separated list of categories to include or exclude (prefix with `-` to exclude).
      - name: countries
        value: us,gb,de
        type: query
        description: Comma-separated list of ISO 3166-1 alpha-2 country codes to include or exclude.
      - name: languages
        value: en,de
        type: query
        description: Comma-separated list of ISO 639-1 language codes to include or exclude.
      - name: keywords
        value: climate change
        type: query
        description: Free-text keywords to search across article title, description, and body.
      - name: date
        value: 2026-05-01,2026-05-28
        type: query
        description: 'Filter by publication date or date range (paid plans only).

          Single date `YYYY-MM-DD` or range `YYYY-MM-DD,YYYY-MM-DD`.

          '
      - name: sort
        value: ''
        type: query
        description: Sort order for results.
      - name: limit
        value: ''
        type: query
        description: Number of results per page (max 100).
      - name: offset
        value: ''
        type: query
        description: Pagination offset.
    docs: 'Retrieve live, real-time news articles aggregated from thousands of publishers worldwide.

      Filter by source, category, country, language, keywords, and date. Supports pagination

      through limit/offset. The `date` parameter enables historical lookups on paid plans.

      '
- info:
    name: Sources
    type: folder
  items:
  - info:
      name: List News Sources
      type: http
    http:
      method: GET
      url: https://api.mediastack.com/v1/sources
      params:
      - name: access_key
        value: ''
        type: query
        description: Mediastack API access key.
      - name: search
        value: ''
        type: query
        description: Free-text search across source name and URL.
      - name: countries
        value: ''
        type: query
        description: Comma-separated list of ISO 3166-1 alpha-2 country codes.
      - name: languages
        value: ''
        type: query
        description: Comma-separated list of ISO 639-1 language codes.
      - name: categories
        value: ''
        type: query
        description: Comma-separated list of categories.
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
    docs: 'Retrieve the catalog of news sources, publishers, and blogs indexed by mediastack.

      Filter by search keyword, country, language, or category to narrow the catalog.

      '
bundled: true

Mediastack

APIs

Mediastack News API

Collections

Mediastack News API

Pricing Plans

Mediastack Plans Pricing

Rate Limits

Mediastack Rate Limits

FinOps

Mediastack Finops

Features

Use Cases

Integrations

Solutions

Semantic Vocabularies

Mediastack Context

API Governance Rules

Mediastack API Rules

JSON Structure

Mediastack News Article Structure

Mediastack Source Structure

Example Payloads

Mediastack Historical News Example

Mediastack List Sources Example

Mediastack Search News Example

Resources

Sources