TheNewsAPI

Global news aggregation REST API providing real-time and historical news articles from thousands of sources with filtering by category, language, country, and search. Indexes over 1 million new articles per week from 40,000+ sources across 50+ countries and 35+ languages.

TheNewsAPI publishes 2 APIs on the APIs.io network: news API and sources API. Tagged areas include News, Articles, Headlines, Media, and Aggregation.

The TheNewsAPI catalog on APIs.io includes 1 Spectral governance ruleset.

TheNewsAPI’s developer surface includes authentication and 2 more developer resources.

🌐 Visit website 📡 Source on GitHub

35.1/100 thin ▬ flat Agent 50/100 agent native Full breakdown ↓
scored 2026-08-21 · rubric v0.12.0

AccessFreemiumSelf serve⚡ Free to try

2 APIs

News Articles Headlines Media Aggregation Real-Time

Kin Score

Kin Score How this is scored →
scored 2026-08-21 · rubric v0.12.0

Composite quality — 35.1/100 · thin

Contract Quality 14.5 / 25

Developer Ergonomics 2.4 / 20

Access Clarity 7.9 / 20

Operational Transparency 2.1 / 13

Contract Governance 1.2 / 12

Discoverability 7.0 / 10

Agent readiness — 50/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 4 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/thenewsapi: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

TheNewsAPI news API

News article retrieval and search

TheNewsAPI sources API

News source discovery

Open Collections 3

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

TheNews news API

OPEN COLLECTION

TheNews news sources API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

TheNewsAPI API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

ArticleListResponse

2 properties

JSON SCHEMA

Article

14 properties

JSON SCHEMA

Source

5 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Get All News

4 fields

EXAMPLE

Get Sources

4 fields

EXAMPLE

Get Top Stories

4 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Thenewsapi Authentication

apiKey · 1 scheme

SECURITY

Thenewsapi Domain Security

TLSv1.3 · DNSSEC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Thenewsapi Agentic Access

6 operations

6 operations · 0 acting

AGENTIC

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

name: TheNewsAPI
description: Global news aggregation REST API providing real-time and historical news articles from thousands of sources with
  filtering by category, language, country, and search. Indexes over 1 million new articles per week from 40,000+ sources
  across 50+ countries and 35+ languages.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.thenewsapi.com/img/logo.png
url: https://www.thenewsapi.com
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.23'
tags:
- News
- Articles
- Headlines
- Media
- Aggregation
- Real-Time
tags_raw:
- news
- articles
- headlines
- media
- aggregation
- real-time
apis:
- aid: thenewsapi:thenewsapi-news-api
  name: TheNewsAPI news API
  description: News article retrieval and search
  humanURL: https://www.thenewsapi.com
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - News
  tags_raw:
  - news
  properties:
  - type: OpenAPI
    url: openapi/thenewsapi-news-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Pricing
    url: https://www.thenewsapi.com/pricing
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Login
    url: https://www.thenewsapi.com/login
  - type: Plans
    url: plans/plans.yml
  - type: RateLimits
    url: rate-limits/rate-limits.yml
  - type: FinOps
    url: finops/finops.yml
- aid: thenewsapi:thenewsapi-sources-api
  name: TheNewsAPI sources API
  description: News source discovery
  humanURL: https://www.thenewsapi.com
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Sources
  tags_raw:
  - sources
  properties:
  - type: OpenAPI
    url: openapi/thenewsapi-sources-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Pricing
    url: https://www.thenewsapi.com/pricing
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Login
    url: https://www.thenewsapi.com/login
  - type: Plans
    url: plans/plans.yml
  - type: RateLimits
    url: rate-limits/rate-limits.yml
  - type: FinOps
    url: finops/finops.yml
common:
- type: AgenticAccess
  url: agentic-access/thenewsapi-agentic-access.yml
- type: DomainSecurity
  url: security/thenewsapi-domain-security.yml
- type: Authentication
  url: authentication/thenewsapi-authentication.yml
- type: Authentication
  data:
    type: apiKey
    in: query
    name: api_token
    description: API token obtained after free registration, passed as a query parameter on all requests
- type: BaseURL
  data:
    url: https://api.thenewsapi.com/v1
- type: Versioning
  data:
    strategy: URL path prefix
    current: v1
- type: DataFormats
  data:
    request: JSON via GET query parameters
    response: JSON
    encoding: UTF-8
- type: ErrorCodes
  data:
  - code: '400'
    status: malformed_parameters
    description: Invalid parameter formatting
  - code: '401'
    status: invalid_api_token
    description: Authentication failure
  - code: '402'
    status: usage_limit_reached
    description: Plan quota exceeded
  - code: '403'
    status: endpoint_access_restricted
    description: Feature unavailable on current plan
  - code: '404'
    status: resource_not_found
    description: Article or endpoint not found
  - code: '429'
    status: rate_limit_reached
    description: Too many requests within 60-second window
  - code: '500'
    status: server_error
    description: Internal service failure
  - code: '503'
    status: maintenance_mode
    description: Service temporarily unavailable
maintainers:
- FN: TheNewsAPI
  url: https://www.thenewsapi.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/thenewsapi"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/thenewsapi/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/thenewsapi/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.