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

41.7/100 thin ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

2 APIs

newsarticlesheadlinesmediaaggregationreal-time

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 41.7/100 · thin

Contract Quality 15.6 / 25

Developer Ergonomics 2.2 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 2.1 / 13

Governance 7.0 / 12

Discoverability 7.0 / 10

Agent readiness — 44/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 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 0 / 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

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.19'
tags:
- 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
  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
  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