The News API

The News API provides free access to search worldwide news and top stories from over 40,000 sources in 50 countries. Access live and historical news articles with advanced filtering by keyword, category, language, country, domain, and date. The API supports boolean search operators, pagination, and returns structured article data including headlines, descriptions, images, and category classifications.

The News API publishes 6 APIs on the APIs.io network, including All News API, Articles API, Headlines API, and 3 more. Tagged areas include Articles, Headlines, News, Media, and Search.

The The News API catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

The News API’s developer surface includes authentication, documentation, signup flow, pricing, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub

50.4/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

6 APIs

ArticlesHeadlinesNewsMediaSearchInternational

Kin Score

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

Composite quality — 50.4/100 · developing

Contract Quality 16.7 / 25

Developer Ergonomics 3.9 / 20

Commercial Clarity 10.0 / 20

Operational Transparency 4.1 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 31/100 · agent aware

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

Request/Response Examples 0 / 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/the-news-api: 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 6

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

Rate Limits 1

Documented rate limits and quota policies.

The News Api Rate Limits

5 limits

RATE LIMITS

FinOps 1

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

JSON Schema 1

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

Examples 1

Example request and response payloads for these APIs.

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Signup

Signup

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

JSONSchema

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRuleset

SpectralRuleset

JSONLDContext

JSONLDContext

Vocabulary

Vocabulary

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Commercial 1

Pricing, plans, and the legal terms of use

Pricing

Pricing

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: the-news-api
name: The News API
description: The News API provides free access to search worldwide news and top stories from over 40,000 sources in 50 countries.
  Access live and historical news articles with advanced filtering by keyword, category, language, country, domain, and date.
  The API supports boolean search operators, pagination, and returns structured article data including headlines, descriptions,
  images, and category classifications.
kind: contract
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
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/the-news-api.png
tags:
- Articles
- Headlines
- News
- Media
- Search
- International
created: '2025-02-09'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/the-news-api/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: the-news-api:the-news-api-all-news-api
  name: The News API All News API
  description: Full historical and live article database search.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - All News
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-all-news-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
- aid: the-news-api:the-news-api-articles-api
  name: The News API Articles API
  description: Retrieve specific articles by UUID.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Articles
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-articles-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
- aid: the-news-api:the-news-api-headlines-api
  name: The News API Headlines API
  description: Latest headlines organized by category.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Headlines
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-headlines-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
- aid: the-news-api:the-news-api-similar-news-api
  name: The News API Similar News API
  description: Articles similar to a given article.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Similar News
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-similar-news-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
- aid: the-news-api:the-news-api-sources-api
  name: The News API Sources API
  description: Available news sources and their metadata.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Sources
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-sources-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
- aid: the-news-api:the-news-api-top-stories-api
  name: The News API Top Stories API
  description: Top stories filtered by keyword, category, and date.
  humanURL: https://www.thenewsapi.com/
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - Top Stories
  properties:
  - type: OpenAPI
    url: openapi/the-news-api-top-stories-api-openapi.yml
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: Signup
    url: https://www.thenewsapi.com/register
  - type: Authentication
    url: https://www.thenewsapi.com/documentation#auth
common:
- type: AgenticAccess
  url: agentic-access/the-news-api-agentic-access.yml
- type: DomainSecurity
  url: security/the-news-api-domain-security.yml
- type: Authentication
  url: authentication/the-news-api-authentication.yml
- type: Website
  url: https://www.thenewsapi.com/
- type: Documentation
  url: https://www.thenewsapi.com/documentation
- type: Signup
  url: https://www.thenewsapi.com/register
- type: Pricing
  url: https://www.thenewsapi.com/pricing
- type: SpectralRuleset
  url: rules/the-news-api-rules.yml
- type: JSONSchema
  url: json-schema/the-news-api-article-schema.json
- type: JSONLDContext
  url: json-ld/the-news-api-context.jsonld
- type: Vocabulary
  url: vocabulary/the-news-api-vocabulary.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

The News API

APIs 6

Open Collections 1

Pricing Plans 1