Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TheNewsAPI news API

News article retrieval and search

TheNewsAPI news API is one of 2 APIs that TheNewsAPI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include news. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and rate-limit docs.

This API exposes 5 operations across 5 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.thenewsapi.com/v1.

5 operations 5 paths 5 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.thenewsapi.com/v1
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

TheNewsAPI news API declares 1 security scheme for authenticating requests. An API key is passed in the query as api_token (ApiToken). By default, every request must be authenticated.

  • ApiToken — API token obtained after free registration at https://www.thenewsapi.com/register

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.

news 5

News article retrieval and search

GET
/news/all
All News
getAllNews 16 params → 200400401402403429500503
GET
/news/top
Top Stories
getTopStories 16 params → 200400401402403429500503
GET
/news/headlines
Headlines
getHeadlines 9 params → 200400401402403429500503
GET
/news/similar/{uuid}
Similar News
getSimilarNews 13 params → 200400401404429500503
GET
/news/uuid/{uuid}
News by UUID
getNewsByUuid 1 param → 200401404429500503

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Article (14 properties), PaginationMeta (4 properties), HeadlinesResponse (2 properties), ArticleListResponse (2 properties). Each schema is shown below with its type and property counts.

PaginationMeta
object
Pagination metadata for list responses.
4 properties
ArticleListResponse
object
Paginated list of news articles.
2 properties
Article
object
A news article with full metadata.
14 properties
ErrorResponse
object
Standard error response.
1 property
HeadlinesResponse
object
Headlines grouped by category.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thenewsapi-news-api-openapi.yml Raw ↑

Other APIs TheNewsAPI publishes across the network.

TheNewsAPI sources API