The Free News API

Documentation

Discover how to use our ✨Free✨ REST News API.

Note:This API is still in development. As a result, there may be occasional bugs, or the server might experience downtime. We follow a versioning system, ensuring that endpoints like news/v1 remain stable with no significant changes as possible.

Buy Me a Coffee

https://www.api.thefreenewsapi.com/api/news/v1

Parameters:

  • query: ?string — The search term to look for
  • max: ?integer — The max number of articles to return
  • apiKey: string — Your API key
  • language: ?string — The language of the news
    • [Available languages: "English", "Dutch", "German", "French" (more coming soon ☺️)]
  • sourceCountry: ?string — The country of the news
    • [Available countries: "UnitedStates", "UnitedKingdom", "Netherlands", "Germany", "France", (more coming soon ☺️)]

Return parameters:

  • title: string — The title of the news
  • description: string — The description of the news
  • sentiment: string — Sentiment analysis result
  • source: string — The source of the news
  • imageUrl: string — URL of the image associated with the news
  • Date: string (ISO 8601 format) — The date of the article
  • websiteUrl: string — URL to the article
  • languages: string — The language of the news returned

Example URL:

https://www.api.thefreenewsapi.com/api/news/v1?apiKey=xxxxx-xxxxx-xxxxx-xxxxx-xxxxx&query=bitcoin&language=English&sourceCountry=UnitedStates&max=3