v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

News Stocks

Trending countries

Returns the countries with the strongest aggregated news coverage activity in the selected period, ranked by buzz_score.

Includes:

buzz_score: normalized 0-100 activity score used for ranking
trend: activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions/articles and source breadth; not price movement. For from/to, anchors at to (or now when to is today)
mentions, unique_tickers, source_count: coverage volume and breadth signals
sentiment_score, bullish_pct, bearish_pct: directional sentiment signals
top_tickers: up to 5 tickers driving the country result

Use source only when you want the ranking filtered to one publisher or source family.

get/news/stocks/v1/trending/countries

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

limitinteger

Maximum number of results

offsetinteger

Number of items to skip for pagination

sourcestring nullable

Optional source filter (strict canonical source id or known alias)

Response

Successful Response

buzz_scorenumber required

Aggregated Buzz Score (0-100)

trend'rising' | 'falling' | 'stable' required

Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions/articles and source breadth; not price movement. For from/to, anchors at to (or now when to is today).

mentionsinteger required

Total mentions

unique_tickersinteger required

Number of unique tickers mentioned

source_countinteger required

Number of distinct news sources with mentions

sentiment_scorenumber required

Weighted average sentiment (-1 bearish to +1 bullish)

bullish_pctinteger required

Percentage of bullish mentions

bearish_pctinteger required

Percentage of bearish mentions

trend_historynumber[] required

Daily dimension buzz scores (oldest to newest). Length follows the resolved period, with a minimum of 7 values. Every slot describes only its UTC calendar day. The live final value describes today so far and can differ from period buzz_score. Closed historical windows end at to.

top_tickersstring[] required

Top 5 tickers by mentions

countrystring required

Country name

Example response

[
  {
    "buzz_score": 82.3,
    "trend": "stable",
    "mentions": 8934,
    "unique_tickers": 156,
    "source_count": 18,
    "sentiment_score": 0.21,
    "bullish_pct": 48,
    "bearish_pct": 26,
    "trend_history": [
      52.1,
      54,
      56.8,
      59.2,
      61,
      60.1,
      82.3
    ],
    "top_tickers": [
      "NVDA",
      "TSLA",
      "AAPL",
      "AMD",
      "PLTR"
    ],
    "country": "United States"
  }
]