News API

Overview

News API is a service that provides developers with access to a vast collection of news articles and blog posts from publishers worldwide. Established in 2017, the API is designed to facilitate the integration of news content into various applications, ranging from content creation tools and media monitoring platforms to academic research projects. It achieves this by offering structured data through HTTP GET requests, returning responses in JSON format.

The API primarily offers two main endpoints: the /v2/top-headlines endpoint and the /v2/everything endpoint. The top-headlines endpoint delivers current and breaking news headlines from a selection of specific sources or categories. This is particularly useful for applications requiring up-to-the-minute news feeds or curated content. In contrast, the everything endpoint provides access to a broader range of articles, allowing for more comprehensive searches across all available sources based on keywords, phrases, or date ranges. A third endpoint, /v2/sources, allows developers to retrieve a list of all available news sources supported by the API, which can be filtered by category, language, or country.

Authentication for News API is managed via an API key, which can be passed either as a query parameter or an HTTP header. This approach simplifies the integration process for developers, as noted in the News API documentation. The service is suitable for developers and technical buyers seeking to enrich their platforms with dynamic news content without the complexities of direct content scraping or managing multiple individual publisher integrations. Its utility extends to use cases such as building news aggregators, populating content recommendation engines, performing sentiment analysis on current events, and supporting journalistic or academic research by providing access to historical news archives.

The developer experience is characterized by straightforward API calls and clear documentation, which includes example usage for various programming languages such as JavaScript, Python, and Node.js. While the API provides access to article metadata and snippets, it generally directs users to the original source for the full article content, adhering to publisher guidelines and intellectual property considerations. For developers building applications that require extensive news data, News API offers a scalable solution, moving from a free developer plan to various paid tiers based on request volume.

Key features

• Top Headlines API: Access current and breaking news headlines, filterable by category, country, or specific news sources. Ideal for real-time news feeds.
• Everything API: Perform comprehensive searches across all available articles and blog posts using keywords, phrases, or date ranges. Supports advanced content discovery.
• Sources API: Retrieve a list of all supported news publishers and their metadata, enabling dynamic source selection within applications.
• Global Coverage: Access news from thousands of sources across multiple countries and languages, providing a broad spectrum of information.
• JSON Responses: All API endpoints return data in a standard JSON format, simplifying parsing and integration into diverse programming environments.
• Simple API Key Authentication: Secure access managed through an API key, passed either in the URL or HTTP headers, streamlining developer setup.
• Developer-Friendly Documentation: Comprehensive API documentation with examples in multiple programming languages, facilitating quick implementation.

Pricing

News API offers a tiered pricing model, including a free developer plan and multiple paid subscriptions. Pricing is based primarily on the number of daily API requests and access to historical data. As of 2026-05-08, the pricing structure is as follows:

For the most current pricing details and specific plan features, developers should consult the official News API pricing page.

Common integrations

News API is commonly integrated into a variety of applications and platforms, leveraging its structured news data. These integrations often involve:

• Content Management Systems (CMS): Embedding news feeds directly into websites or blogs to keep content fresh and relevant.
• Data Analytics Platforms: Feeding news data into tools for trend analysis, media monitoring, and sentiment analysis. For example, integrating with custom Python scripts that use libraries like pandas for data processing.
• Mobile Applications: Powering news aggregators and personalized news feeds on iOS and Android devices.
• Customer Relationship Management (CRM) Systems: Providing sales or support teams with real-time news relevant to their clients or industry.
• Business Intelligence (BI) Dashboards: Displaying contextual news alongside other business metrics to inform decision-making.
• Voice Assistants and Chatbots: Enabling these interfaces to deliver current event information or answer news-related queries.
• Academic Research Tools: Collecting and analyzing large datasets of news articles for linguistic studies, social science research, or historical analysis, as discussed in various data-driven research methodologies.

Alternatives

Developers seeking alternatives to News API have several options, each with distinct features and pricing models:

• NewsCatcher API: Offers a similar service with extensive historical data, real-time news, and an emphasis on data quality and coverage.
• GNews API: Provides a free and paid API for searching and extracting news articles, often highlighted for its simplicity and direct access to Google News sources.
• mediastack: Focuses on delivering real-time news data from thousands of global sources, with a free tier and various paid plans supporting high request volumes.

Getting started

To begin using News API, you typically register for an API key on their website. Once you have your key, you can make HTTP GET requests to their endpoints. Here's a basic example using Python with the requests library to fetch top headlines:

import requests
import json

# Replace 'YOUR_API_KEY' with your actual News API key
API_KEY = 'YOUR_API_KEY'

# Define the endpoint for top headlines
url = 'https://newsapi.org/v2/top-headlines'

# Set parameters for the request
params = {
    'country': 'us',  # Example: Get headlines from the United States
    'category': 'technology', # Example: Get technology headlines
    'apiKey': API_KEY
}

try:
    # Make the GET request
    response = requests.get(url, params=params)
    response.raise_for_status() # Raise an exception for HTTP errors (4xx or 5xx)

    # Parse the JSON response
    data = response.json()

    # Print some information from the response
    print(f"Total results: {data.get('totalResults')}")
    if data.get('articles'):
        print("\n--- Latest Technology Headlines (US) ---")
        for article in data['articles'][:5]: # Print first 5 articles
            print(f"Title: {article.get('title')}")
            print(f"Source: {article.get('source', {}).get('name')}")
            print(f"URL: {article.get('url')}\n")
    else:
        print("No articles found for the specified criteria.")

except requests.exceptions.RequestException as e:
    print(f"An error occurred: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON from response.")

This Python script sends a request to the /v2/top-headlines endpoint, specifying the country as 'us' and the category as 'technology'. It then prints the total number of results and the titles, sources, and URLs of the first five articles. Remember to replace 'YOUR_API_KEY' with your actual API key obtained from the News API website.