# Real-Time News Data - Google News Headlines & Coverage

> Fast and reliable news data API - get top news globally or per topic and search for news by query and geographic area from Google News in real-time.

## Overview

Real-Time News Data is a fast and reliable API for news from Google News and the web in real-time. It returns top, topic, and local headlines plus full story coverage as structured JSON via REST.

Who is this API for: developers building news aggregators, media monitoring and PR tools, research dashboards, and content feeds.

What it returns: news search, top headlines, topic and section headlines, local (geo) headlines, full story coverage, and supported language lists.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /search - Search
Search news articles by query with an option to limit the results to a specific time range.
Parameters:
- **query** (string, required, e.g. `Elon Musk`): Search query for which to get news.
- limit (integer, default: `10`): Maximum number of news articles to return.
- time_published (string, default: `anytime`): Find news articles published in a specific time range.
- source (string, e.g. `cnn.com`): Domain of the source from which to return news articles.
- country (string, default: `us`): Country code. See all available country codes.
- language (string, default: `en`): The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/realtime-news-data/search`

### GET /top-headlines - Top Headlines
Get the latest news headlines/top stories for a country.
Parameters:
- limit (integer, default: `500`): Maximum number of news articles to return.
- country (string, e.g. `US`): Country code. See all available country codes. Default: US
- language (string, default: `en`): The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/realtime-news-data/top-headlines`

### GET /topic-headlines - Topic Headlines
Get the latest news headlines for a topic (World, Sports, Technology, etc) or publication (e.g.
Parameters:
- **topic** (string, required, allowed: WORLD | NATIONAL | BUSINESS | TECHNOLOGY | ENTERTAINMENT | SPORTS | SCIENCE | HEALTH, e.g. `WORLD`): Topic or publication for which to get news headlines. In addition, topic / publication IDs are also accepted and can be taken from a News topic URL as it appears after the topics/ or publications/ path part (e.g. Football Topic - /topics/CAAqJQgKIh9DQkFTRVFvSUwyMHZNREoyZURRU0JXVnVMVWRDS0FBUAE).
- limit (integer, default: `500`): Maximum number of news articles to return.
- country (string, default: `us`): Country code. See all available country codes.
- language (string, default: `en`): The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/realtime-news-data/topic-headlines`

### GET /topic-news-by-section - Topic News By Section
Get news article in a specific section of a topic (World, Sports, Technology, etc) or publication (CNN, BBC, etc).
Parameters:
- **topic** (string, required, allowed: WORLD | NATIONAL | BUSINESS | TECHNOLOGY | ENTERTAINMENT | SPORTS | SCIENCE | HEALTH, e.g. `WORLD`): Topic or publication for which to get news headlines. In addition, topic / publication IDs are also accepted and can be taken from a News topic URL as it appears after the topics/ or publications/ path part (e.g. Football Topic - /topics/CAAqJQgKIh9DQkFTRVFvSUwyMHZNREoyZURRU0JXVnVMVWRDS0FBUAE).
- section (string, e.g. `CAQiSkNCQVNNUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENJT0NBUWFDZ29JTDIwdk1ETnliSFFxQ2hJSUwyMHZNRE55YkhRb0FBKi4IACoqCAoiJENCQVNGUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENnQVABUAE`)
- limit (integer, default: `500`): Maximum number of news articles to return.
- country (string, default: `us`): Country code. See all available country codes.
- language (string, default: `en`): The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/realtime-news-data/topic-news-by-section`

### GET /local-headlines - Local Headlines (Geo)
Get local, geo based headlines.
Parameters:
- **query** (string, required, e.g. `New York`): Area, city or country to fetch news for (e.g. London).
- country (string, default: `us`): Country code. See all available country codes.
- language (string, default: `en`): The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2.
- limit (integer, default: `500`): Maximum number of news articles to return.
Full URL: `https://api.openwebninja.com/realtime-news-data/local-headlines`

### GET /full-story-coverage - Full Story Coverage
Get the full story coverage, including all sub articles, top news, and posts from X (formerly Twitter).
Parameters:
- **story** (string, required, e.g. `CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2pzbFA3X0N4RjlDUlpVVnhudXBpZ0FQAQ`): The Story ID for which to get full coverage. Story IDs are returned for news articles with sub_articles from any of the endpoint returning news articles. In addition, Story IDs can be obtained from a News Story URL as it appears after the stories/path part (e.g. /stories/CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2pzbFA3X0N4RjlDUlpVVnhudXBpZ0FQAQ) after navigating to an article's Full Coverage.
- sort (string, allowed: RELEVANCE | DATE, e.g. `RELEVANCE`): Return articles (i.e. all_articles list) in a specific sort order.
Full URL: `https://api.openwebninja.com/realtime-news-data/full-story-coverage`

### GET /language-list - Language List
Get valid languages for a country code, to be used with all other APIs.
Parameters:
- **country** (string, required, e.g. `us`): Country code of the country to get languages for. See all available country codes.
Full URL: `https://api.openwebninja.com/realtime-news-data/language-list`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/realtime-news-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-news-data

## Topics

news data api, google news api, news headlines api, news aggregator api, media monitoring api, top headlines api, news search api, real-time news api, story coverage api

## Links

- API page: https://www.openwebninja.com/api/real-time-news-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-news-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-news-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_news_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-05-27_