News Stocks

Compare stocks

Compare multiple stock tickers side by side using the news sentiment dataset and buzz model.

Use it when you already know the tickers and want a compact ranked table instead of full detail reports. Results are sorted by buzz_score descending and include trend, trend_history, source_count, sentiment_score, bullish_pct and bearish_pct. trend is 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).

get/news/stocks/v1/compare

Query parameters

fromstring date nullable

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

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.

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.

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

tickersstring required

Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)

Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)

Response

Successful Response

period_daysinteger required

Analysis period in days

Example response

{
  "period_days": 7,
  "stocks": [
    {
      "ticker": "TSLA",
      "company_name": "Tesla, Inc.",
      "buzz_score": 87.5,
      "trend": "rising",
      "mentions": 342,
      "source_count": 8,
      "sentiment_score": 0.23,
      "bullish_pct": 45,
      "bearish_pct": 18,
      "trend_history": [
        45.2,
        52.1,
        48.7,
        67.3,
        72.1,
        78.4,
        87.5
      ]
    },
    {
      "ticker": "NVDA",
      "company_name": "NVIDIA Corporation",
      "buzz_score": 72.3,
      "trend": "stable",
      "mentions": 189,
      "source_count": 6,
      "sentiment_score": 0.45,
      "bullish_pct": 51,
      "bearish_pct": 16,
      "trend_history": [
        36.5,
        41.2,
        46.8,
        53.4,
        60.3,
        66.1,
        72.3
      ]
    }
  ]
}