Which endpoint should I use: /search or /top?

Use `/search` for keyword queries and specific filtering. Use `/top` for trending and breaking news without keyword requirements. Both support country, topic, and language filters.

Can I combine multiple filters in one request?

Yes. Combine `country`, `language`, `topic`, `political_leaning`, `source_type`, and date ranges in a single request for precise queries.

How do I handle pagination efficiently?

Use cursor-based pagination. Save the `cursor` from each response and pass it in the next request with `page_size`. Don't change filters mid-pagination to avoid inconsistent results.

What's the rate limit for NewsDataHub API?

Free tier: 100 requests/day. Paid tiers offer higher limits. Check your plan details in the dashboard. Implement exponential backoff for 429 rate limit responses.

Can I get real-time notifications for breaking news?

Use the `/top` endpoint with short polling intervals (every 5-15 minutes) for near-real-time updates. Webhooks for push notifications are on the roadmap.

What Is NewsDataHub API and How Do I Integrate Real-Time News Data?

intermediate 10 min read September 26, 2025

newsdatahub apinews apireal-time newsnews filteringapi integration

In the fast-paced world of today, getting real-time news is more important than ever. Whether you’re building a news aggregation platform, integrating a news feed into an existing app, or conducting data analysis on world events, a reliable news API is essential. Enter the NewsDataHub API, a powerful tool that allows developers to access and filter real-time news from around the world.

This guide aims to provide a comprehensive look at the NewsDataHub API, focusing on its /v1/news endpoint which is pivotal for real-time news access and filtering capabilities. It will cover authentication, key filtering parameters, and practical examples of implementation. Let’s dive in!

Getting Started: Authentication

The first step to using the NewsDataHub API is authenticating your requests. This is done using the X-API-Key header. When you sign up for NewsDataHub, you’ll receive a unique API key that should be included in the header of every request made to the API.

Here’s an example in Python using the requests library:

import requests

api_key = 'your_api_key_here'
headers = {
    'X-API-Key': api_key,
    'User-Agent': 'newsdatahub-api-comprehensive-guide/1.0-py'
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers)

The /v1/news Endpoint: Accessing Real-Time News

The /v1/news endpoint is your gateway to real-time news. It returns a list of the latest news articles from sources around the world.

An unfiltered request to this endpoint returns the most recent news from all sources in all languages. However, you can customize the news you receive by using various filtering parameters.

Filtering the News: Country, Topic, Language, Source, and Date Ranges

The NewsDataHub API provides several different parameters that can be used to filter the news articles returned by the /v1/news endpoint. These parameters include:

country: The country where the news originated.
topic: The topic of the news.
language: The language in which the news is written.
source: The source from which the news originated.
start_date and end_date: The date range during which the news was published (max 90-day range).

Here’s an example request that filters news by country (United States), topic (Technology), and language (English):

params = {
    'country': 'US',
    'topic': 'technology',
    'language': 'en',
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)

Implementing News Feeds: Real-World Examples

With the NewsDataHub API, implementing real-time news feeds in your applications is straightforward. Below are production-ready examples for different industries and use cases.

Financial Services Monitoring

Track banking, fintech, and financial services news with precision:

import requests

api_key = 'your_api_key_here'
headers = {
    'X-API-Key': api_key,
    'User-Agent': 'newsdatahub-api-comprehensive-guide/1.0-py'
}
params = {
    'q': '(banking OR fintech OR "financial services" OR "digital banking")',
    'topic': 'finance',
    'country': 'US',
    'language': 'en',
    'search_in': 'title,description'
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)
response_data = response.json()
articles = response_data['data']

for article in articles:
    print(f"Title: {article['title']}")
    print(f"Source: {article['source_title']}")
    print(f"Published: {article['pub_date']}")
    print(f"URL: {article['article_link']}")
    print("\n")

Live feed: Financial News

Supply Chain Risk Assessment

Monitor logistics disruptions, shortages, and supply chain bottlenecks:

params = {
    'q': '("supply chain" OR logistics OR shipping OR freight) AND (shortage OR delay OR disruption OR bottleneck OR crisis)',
    'search_in': 'title',
    'language': 'en',
    'per_page': 50
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)

Use case: Supply chain managers monitoring global bottlenecks Live feed: Supply Chain News

Cybersecurity Threat Intelligence

Track data breaches, ransomware attacks, and security threats:

params = {
    'q': '(cybersecurity OR "cyber attack" OR "data breach" OR ransomware) AND (threat OR attack OR breach OR hack)',
    'search_in': 'title',
    'language': 'en',
    'per_page': 50
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)

Use case: Security teams monitoring global threat landscape Live feed: Cybersecurity News

Geopolitical Risk Monitoring

Monitor international conflicts and regional tensions:

# Ukraine war coverage
params = {
    'q': '(Ukraine OR Russia) AND (war OR conflict OR military OR invasion)',
    'language': 'en',
    'per_page': 50
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)

Use case: Defense analysts tracking military developments Live feed: Ukraine War News

Corporate Intelligence

Track layoffs, mergers, acquisitions, and corporate actions:

# Corporate layoffs tracking
params = {
    'q': '(layoffs OR "job cuts" OR "hiring freeze" OR "workforce reduction")',
    'search_in': 'title',
    'language': 'en',
    'per_page': 50
}

response = requests.get('https://api.newsdatahub.com/v1/news', headers=headers, params=params)

Use case: HR professionals tracking workforce trends Live feed: Layoffs News

Explore 32+ more production queries: Live Feeds Repository — including fraud detection, corporate legal news, technology outages, healthcare costs, climate change, elections, and regional monitoring.

Accessing Pagination Data

# You can access pagination info from any response
print(f"Total results: {response_data['total_results']}")
print(f"Results per page: {response_data['per_page']}")
if response_data.get('next_cursor'):
    print(f"Next page cursor: {response_data['next_cursor']}")

Getting Started with NewsDataHub

The NewsDataHub API offers different subscription tiers to meet various development needs. For current pricing, rate limits, and feature availability by tier, please check the official NewsDataHub documentation as these details are updated regularly.

Wrapping Up

The NewsDataHub API is an incredibly powerful tool for developers who need to access and filter real-time news. Its flexibility and ease of use make it a top choice for a wide variety of applications, from news aggregation platforms to data analysis tools.

As a next step, consider exploring the API’s documentation further and experimenting with the different filtering parameters. Happy coding!

Continue Your API Journey

Ready to learn more?

Country-Specific News with NewsDataHub: Filter Headlines by Country - Learn how to filter news by country using ISO codes, combine multiple countries, and integrate country filtering with other parameters for precise results.

FAQ

Which endpoint should I use: /search or /top?

Use /search for keyword queries and specific filtering. Use /top for trending and breaking news without keyword requirements. Both support country, topic, and language filters.
Can I combine multiple filters in one request?

Yes. Combine country, language, topic, political_leaning, source_type, and date ranges in a single request for precise queries.
How do I handle pagination efficiently?

Use cursor-based pagination. Save the cursor from each response and pass it in the next request with page_size. Don’t change filters mid-pagination to avoid inconsistent results.
What’s the rate limit for NewsDataHub API?

Free tier: 100 requests/day. Paid tiers offer higher limits. Check your plan details in the dashboard. Implement exponential backoff for 429 rate limit responses.
Can I get real-time notifications for breaking news?

Use the /top endpoint with short polling intervals (every 5-15 minutes) for near-real-time updates. Webhooks for push notifications are on the roadmap.

Olga S.

Founder of NewsDataHub — Distributed Systems & Data Engineering

Connect on LinkedIn