aid: mediastack
name: Mediastack
description: >-
  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.
url: https://mediastack.com
humanURL: https://mediastack.com
baseURL: https://api.mediastack.com/v1
deliveryModel:
  model: unknown
  open_source: unknown
  commercial: true
  callable_host: true
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - openapi
  - pricing
  - repository-unlicensed
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://mediastack.com/site_images/mediastack_logo_dark.svg
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-category: News
x-tier: 2
x-tier-reason: company-tiered-commercial-news-aggregation
x-docs-platform: redoc
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-10-04
tags:
  - News
  - News Aggregation
  - Media
  - APILayer
  - Public APIs
tags_raw:
  - News
  - News Aggregation
  - Media
  - Apilayer
  - Public APIs
apis:
- aid: mediastack:mediastack-news-api
  name: Mediastack News API
  description: Live and historical news articles from global publishers.
  humanURL: https://mediastack.com/documentation
  baseURL: https://api.mediastack.com/v1
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/mediastack-news-api-openapi.yml
  - type: Documentation
    url: https://docs.apilayer.com/mediastack/docs/api-documentation
  - type: APIReference
    url: https://mediastack.com/documentation
  - type: GettingStarted
    url: https://mediastack.com/documentation#quickstart
  - type: Authentication
    url: https://mediastack.com/documentation#authentication
  - type: JSONSchema
    url: json-schema/mediastack-news-article-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-source-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-pagination-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-error-schema.json
  - type: JSONStructure
    url: json-structure/mediastack-news-article-structure.json
  - type: JSONStructure
    url: json-structure/mediastack-source-structure.json
  - type: Examples
    url: examples/mediastack-search-news-example.json
  - type: Examples
    url: examples/mediastack-list-sources-example.json
  - type: Examples
    url: examples/mediastack-historical-news-example.json
- aid: mediastack:mediastack-sources-api
  name: Mediastack Sources API
  description: Discovery of supported news sources, publishers, and blogs.
  humanURL: https://mediastack.com/documentation
  baseURL: https://api.mediastack.com/v1
  tags:
  - Sources
  properties:
  - type: OpenAPI
    url: openapi/mediastack-sources-api-openapi.yml
  - type: Documentation
    url: https://docs.apilayer.com/mediastack/docs/api-documentation
  - type: APIReference
    url: https://mediastack.com/documentation
  - type: GettingStarted
    url: https://mediastack.com/documentation#quickstart
  - type: Authentication
    url: https://mediastack.com/documentation#authentication
  - type: JSONSchema
    url: json-schema/mediastack-news-article-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-source-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-pagination-schema.json
  - type: JSONSchema
    url: json-schema/mediastack-error-schema.json
  - type: JSONStructure
    url: json-structure/mediastack-news-article-structure.json
  - type: JSONStructure
    url: json-structure/mediastack-source-structure.json
  - type: Examples
    url: examples/mediastack-search-news-example.json
  - type: Examples
    url: examples/mediastack-list-sources-example.json
  - type: Examples
    url: examples/mediastack-historical-news-example.json
common:
  - type: CapabilityMap
    url: capabilities/mediastack-capability-edges.yml
    name: Mediastack Business Capability Map
  - type: IssueTracker
    url: https://github.com/apilayer/mediastack/issues
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/mediastack/overview
  - type: AgenticAccess
    url: agentic-access/mediastack-agentic-access.yml
  - type: DomainSecurity
    url: security/mediastack-domain-security.yml
  - type: Authentication
    url: authentication/mediastack-authentication.yml
  - type: Website
    url: https://mediastack.com
  - type: Portal
    url: https://mediastack.com/dashboard
  - type: Signup
    url: https://mediastack.com/signup/free
  - type: Pricing
    url: https://mediastack.com/product
  - type: TermsOfService
    url: https://mediastack.com/terms
  - type: PrivacyPolicy
    url: https://mediastack.com/privacy
  - type: Support
    url: https://mediastack.com/contact
  - type: FAQ
    url: https://mediastack.com/documentation#faq
  - type: GitHubRepository
    url: https://github.com/apilayer/mediastack
  - type: PublicAPIsListing
    url: https://github.com/public-apis/public-apis
  - type: JSONLD
    url: json-ld/mediastack-context.jsonld
  - type: SpectralRules
    url: rules/mediastack-rules.yml
  - type: Vocabulary
    url: vocabulary/mediastack-vocabulary.yml
  - type: Plans
    url: plans/mediastack-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/mediastack-rate-limits.yml
  - type: FinOps
    url: finops/mediastack-finops.yml
  - type: Features
    data:
      - name: Live News Data
        description: Real-time aggregation of articles from 7,500+ global news publishers.
      - name: Historical News
        description: Date-bounded lookups of past articles via the date query parameter (paid plans).
      - name: Multi-Language Coverage
        description: Articles indexed across 13 languages including English, German, Spanish, French, Chinese, and Arabic.
      - name: Multi-Country Coverage
        description: Filter by 50+ country codes using ISO 3166-1 alpha-2.
      - name: Category Filtering
        description: Restrict to general, business, entertainment, health, science, sports, or technology.
      - name: Source Filtering
        description: Include/exclude lists of specific publishers via comma-separated IDs.
      - name: Keyword Search
        description: Full-text search across article title, description, and body.
      - name: Publisher Catalog
        description: Browse the /sources catalog by country, language, or category.
      - name: HTTPS Encryption
        description: Encrypted transport on Standard plan and above.
      - name: Commercial Use License
        description: Permitted on Standard plan and above.
  - type: UseCases
    data:
      - name: News Aggregator Apps
        description: Power consumer-facing news readers with category- and language-filtered feeds.
      - name: Media Monitoring
        description: Track brand, executive, product, or competitor mentions across global press.
      - name: Investor Research
        description: Stream business-tagged headlines into trading dashboards.
      - name: AI Training Corpora
        description: Sample current-events text for fine-tuning and retrieval-augmented generation.
      - name: Trend Analysis
        description: Tally publication volume and sentiment around recurring keywords.
      - name: Newsletter Curation
        description: Auto-generate daily digests by country, language, or topic.
  - type: Integrations
    data:
      - name: apilayer Marketplace
        description: >-
          Mediastack is one of several APIs in the apilayer marketplace alongside marketstack, currencylayer,
          weatherstack, and ipapi.
      - name: REST + JSON
        description: Standard HTTPS+JSON makes it trivial to integrate with any HTTP client library.
      - name: Postman / Insomnia
        description: Manual import of the OpenAPI spec into common API clients.
  - type: Solutions
    data:
      - name: Free Plan
        description: Evaluation tier, 100 requests/month, HTTP only, no historical data, no commercial use.
      - name: Standard Plan
        description: $24.99/month, 10k requests, HTTPS, historical data, commercial use.
      - name: Professional Plan
        description: $99.99/month, 50k requests, lower overage rate.
      - name: Business Plan
        description: $249.99/month, 250k requests, lowest published overage rate.
      - name: Enterprise Plan
        description: Custom volume, platinum support, custom solutions.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com
