NewsAPI

NewsAPI is a simple, easy-to-use REST API that returns JSON metadata for news articles and breaking headlines published by over 80,000 worldwide sources and blogs. The API supports full-text keyword search across hundreds of millions of articles, filtering by source domain, language, date range, and sorting by relevance or publication date. A dedicated top-headlines endpoint delivers live breaking news by country and category — covering business, entertainment, general, health, science, sports, and technology. Developers authenticate via an API key passed as a query parameter or HTTP header, and all responses are returned as standard JSON.

NewsAPI publishes 3 APIs on the APIs.io network: Everything API, Sources API, and Top Headlines API. Tagged areas include News, Headlines, Articles, Search, and Media.

The NewsAPI catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

NewsAPI’s developer surface includes authentication, documentation, engineering blog, pricing, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub

46.6/100 developing ▬ flat Agent 35/100 agent ready saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessFreemiumSelf serve⚡ Free to try

1 APIs

News Headlines Articles Search Media Content REST JSON

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 46.6/100 · developing

Contract Quality 17.2 / 25

Developer Ergonomics 4.8 / 20

Access Clarity 10.0 / 20

Operational Transparency 4.8 / 13

Contract Governance 3.0 / 12

Discoverability 6.9 / 10

Agent readiness — 35/100 · agent ready

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

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics does not apply to this provider. The published contracts declare no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's denominator entirely — not scored zero. A reference or data API is not deficient for being unable to upsert.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/newsapi: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 3

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

NewsAPI Everything API

Search all articles from all sources

NewsAPI Sources API

Get available news sources

NewsAPI Top Headlines API

Get live top and breaking headlines

Open Collections 4

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

API Collection

OPEN COLLECTION

News Everything API

OPEN COLLECTION

News Everything Sources API

OPEN COLLECTION

News Everything Top Headlines API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Newsapi Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Newsapi Rate Limits

5 limits

RATE LIMITS

FinOps 1

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

Newsapi Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Newsapi Context

2 classes · 29 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

NewsAPI API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

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

Article

8 properties

JSON SCHEMA

ErrorResponse

3 properties

JSON SCHEMA

NewsSource

7 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Newsapi Everything Example

2 fields

EXAMPLE

Newsapi Sources Example

2 fields

EXAMPLE

Newsapi Top Headlines Example

2 fields

EXAMPLE

Security Posture 2

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

Newsapi Authentication

apiKey/http · 3 schemes

SECURITY

Newsapi Domain Security

TLSv1.3

SECURITY

Agentic Access 1

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

Newsapi Agentic Access

3 operations

3 operations · 0 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg

GitHubOrg

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 2

Status, limits, changes, and where to get help

StatusPage

StatusPage

RateLimits

RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

Plans

Plans

FinOps

FinOps

Company 3

The organization behind the API

Website

Website

LinkedIn

Blog

Blog

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

aid: newsapi
name: NewsAPI
description: 'NewsAPI is a simple, easy-to-use REST API that returns JSON metadata for news articles and breaking headlines
  published by over 80,000 worldwide sources and blogs. The API supports full-text keyword search across hundreds of millions
  of articles, filtering by source domain, language, date range, and sorting by relevance or publication date. A dedicated
  top-headlines endpoint delivers live breaking news by country and category — covering business, entertainment, general,
  health, science, sports, and technology. Developers authenticate via an API key passed as a query parameter or HTTP header,
  and all responses are returned as standard JSON.

  '
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  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://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/newsapi.png
url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/apis.yml
created: '2026-06-12'
modified: '2026-06-12'
specificationVersion: '0.23'
tags:
- News
- Headlines
- Articles
- Search
- Media
- Content
- REST
- JSON
apis:
- aid: newsapi:newsapi-everything-api
  name: NewsAPI Everything API
  description: Search all articles from all sources
  humanURL: https://newsapi.org/
  baseURL: https://newsapi.org/v2
  tags:
  - Everything
  properties:
  - type: OpenAPI
    url: openapi/newsapi-everything-api-openapi.yml
  - type: Documentation
    url: https://newsapi.org/docs
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-article-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-source-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-error-schema.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/vocabulary/newsapi-vocabulary.yml
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-ld/newsapi-context.jsonld
- aid: newsapi:newsapi-sources-api
  name: NewsAPI Sources API
  description: Get available news sources
  humanURL: https://newsapi.org/
  baseURL: https://newsapi.org/v2
  tags:
  - Sources
  properties:
  - type: OpenAPI
    url: openapi/newsapi-sources-api-openapi.yml
  - type: Documentation
    url: https://newsapi.org/docs
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-article-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-source-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-error-schema.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/vocabulary/newsapi-vocabulary.yml
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-ld/newsapi-context.jsonld
- aid: newsapi:newsapi-top-headlines-api
  name: NewsAPI Top Headlines API
  description: Get live top and breaking headlines
  humanURL: https://newsapi.org/
  baseURL: https://newsapi.org/v2
  tags:
  - Top Headlines
  properties:
  - type: OpenAPI
    url: openapi/newsapi-top-headlines-api-openapi.yml
  - type: Documentation
    url: https://newsapi.org/docs
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-article-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-source-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-error-schema.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/vocabulary/newsapi-vocabulary.yml
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-ld/newsapi-context.jsonld
common:
- type: AgenticAccess
  url: agentic-access/newsapi-agentic-access.yml
- type: DomainSecurity
  url: security/newsapi-domain-security.yml
- type: Authentication
  url: authentication/newsapi-authentication.yml
- type: Website
  url: https://newsapi.org/
- type: Documentation
  url: https://newsapi.org/docs
- type: GitHubOrg
  url: https://github.com/News-API-gh
- type: LinkedIn
  url: https://www.linkedin.com/company/newsapi
- type: Blog
  url: https://newsapi.org/blog
- type: Pricing
  url: https://newsapi.org/pricing
- type: StatusPage
  url: https://newsapi.org/status
- type: X
  url: https://x.com/newsapi
- type: Plans
  url: plans/newsapi-plans-pricing.yml
- type: RateLimits
  url: rate-limits/newsapi-rate-limits.yml
- type: FinOps
  url: finops/newsapi-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.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/newsapi"

All providers

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

Every operation they expose

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

How their score was established

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

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

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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