News signals and trends
GDELT-derived sentiment and attention signals per entity and ticker, trending people and topics, and the most-covered stories.
Signals derived from GDELT's 15-minute global news coding: tone in basis points, mention volume against a 30-day baseline, novelty and trending for organisations, tickers, crypto assets, central banks, governments and topics; trending people and topics ranked by attention spike (Wikipedia pageviews, GDELT, Google Trends, Mastodon); and the 50 most-covered stories per window. No article text.
Collection ok, last fetch 2026-11-11T05:47:01Z. RealtimeAPI feed newssignals. Machine copies: OpenAPI, pricing JSON.
Endpoints
| Endpoint | What | Cadence | Per request | MCP tool |
|---|---|---|---|---|
GET /news/api/v1/entities | The tracked entities: organisations, tickers, crypto assets, central banks, governments and topics, with ids, aliases and baselines. | Refreshes every 24 hours. | $0.005 | news_search_entities |
GET /news/api/v1/sentiment/{entity} | News tone and volume for one entity over a window: mentions, 30-day baseline, volume ratio, novelty, tone in basis points and top themes. | Refreshes every 15 minutes. | $0.010 | news_sentiment |
GET /news/api/v1/tickers/{symbol}/news-score | News score for a ticker or crypto symbol: mentions against baseline, volume ratio, novelty, tone and tone change, top themes. | Refreshes every 15 minutes. | $0.010 | news_ticker_score |
GET /news/api/v1/entities/trending | Entities with the most unusual news volume in the window, ranked by novelty against their 30-day baseline. | Refreshes every 15 minutes. | $0.015 | news_trending |
GET /news/api/v1/events | GDELT-coded events (CAMEO) newest first: actors, event code, Goldstein scale, mentions, tone, country and the source URL. | Refreshes every 15 minutes. | $0.010 | |
GET /news/api/v1/sentiment/{entity}/history | Mentions and tone per 15-minute window (last 90 days) or per day for one entity, newest first, for backtests. | Refreshes every 15 minutes. | $0.020 | news_sentiment_history |
GET /news/api/v1/trending/people | Public figures with the biggest attention spike against their 30-day baseline (Wikipedia pageviews and news coverage), by category: celebrity, politics, sport, business. | Refreshes every 60 minutes. | $0.015 | news_trending_people |
GET /news/api/v1/trending/topics | Trending topics for a region: top daily searches with approximate traffic and three headlines each, plus trending Mastodon tags and shared links. | Refreshes every 60 minutes. | $0.015 | news_trending_topics |
GET /news/api/v1/top-stories | The most-covered stories in the window (up to 50): title, link, publisher, tone and how many GDELT records cited the URL. No article text. | Refreshes every 15 minutes. | $0.010 | news_top_stories |
First calls
GET /news/api/v1/tickers/NVDA/news-score?window=24h(MCPnews_ticker_score): how unusual today's news volume and tone are for a tickerGET /news/api/v1/entities/trending?window=24h(MCPnews_trending): which entities have the most unusual coverage right nowGET /news/api/v1/trending/people?category=celebrity(MCPnews_trending_people): which public figures are spiking in attentionGET /news/api/v1/top-stories?window=6h(MCPnews_top_stories): the most-covered stories, title and link only
Example prompts
- "Which S&P 500 names have the most unusual news volume today?"
- "What is the 24-hour news tone for Bitcoin versus its 30-day baseline?"
- "Which celebrities are spiking in attention right now, and why?"
- "What is trending in Australia today?"
- "Give me the ten most-covered stories of the last six hours with links."
- "How did news tone for the Federal Reserve move over the last week?"
Sources and licences
| Publisher | What | Licence |
|---|---|---|
| The GDELT Project | 15-minute global news coding: entities, themes and tone (GKG) and CAMEO events. | open, citation required |
| Wikimedia Foundation (Pageviews API) | Daily Wikipedia article pageviews: the attention series behind trending people. | open data (CC0 for pageview statistics) |
| Wikidata | Whether an article is a person, and their occupations (celebrity, politics, sport, business). | CC0 1.0 |
| Google Trends (daily trends RSS) | Top daily searches per country with approximate traffic and three headlines each. | public feed, terms unstated (confirm) |
| Mastodon instances (mastodon.social, mastodon.online) | Trending hashtags and shared links. | public API, per-instance terms |
Attribution travels in the source array of every response.
Through RealtimeAPI.ai
The same endpoints are the feed newssignals on RealtimeAPI.ai, with 1,000 free calls a month on one rta_live_ key across every feed. Paths are identical after the feed slug:
curl https://api.realtimeapi.ai/v1/newssignals/api/v1/tickers/NVDA/news-score?window=24h -H "X-API-Key: rta_live_..."