TheNewsAPI

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.
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:
- name: TheNewsAPI
  description: RESTful API for accessing real-time and historical news articles, top stories, headlines, and related news
    from thousands of global sources with advanced filtering by category, language, country, date, and full-text search.
  image: https://www.thenewsapi.com/img/logo.png
  humanURL: https://www.thenewsapi.com
  baseURL: https://api.thenewsapi.com/v1
  tags:
  - news
  - headlines
  - articles
  - aggregation
  properties:
  - type: Documentation
    url: https://www.thenewsapi.com/documentation
  - type: OpenAPI
    url: openapi/openapi.json
  - 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
  contact:
  - FN: TheNewsAPI Support
    url: https://www.thenewsapi.com/contact
    email: ''
  endpoints:
  - name: All News
    description: Search and filter the entire article database with comprehensive filtering options including search, categories,
      language, country, domain, and date range.
    url: https://api.thenewsapi.com/v1/news/all
    method: GET
    tag: news
  - name: Top Stories
    description: Retrieve live and historical top stories with advanced filtering by category, language, country, and full-text
      search with boolean operators.
    url: https://api.thenewsapi.com/v1/news/top
    method: GET
    tag: news
  - name: Headlines
    description: Get the latest headlines organized by category with optional similar article grouping. Available on Standard
      plan and above.
    url: https://api.thenewsapi.com/v1/news/headlines
    method: GET
    tag: news
  - name: Similar News
    description: Find articles related to a specific article by UUID with optional category, domain, language, and date filters.
    url: https://api.thenewsapi.com/v1/news/similar/{uuid}
    method: GET
    tag: news
  - name: News by UUID
    description: Retrieve a specific article by its unique UUID identifier.
    url: https://api.thenewsapi.com/v1/news/uuid/{uuid}
    method: GET
    tag: news
  - name: Sources
    description: List all available news sources that can be used for filtering, including metadata on category and language
      coverage.
    url: https://api.thenewsapi.com/v1/news/sources
    method: GET
    tag: sources
common:
- 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