from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the current UTC day so far. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
limit- Maximum results, 1 to 100Default 20
offset- Skip the first N results for paginationDefault 0
type- Asset type: stock, etf or allDefault all
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the current UTC day so far. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
limit- Maximum results, 1 to 100Default 20
offset- Skip the first N results for paginationDefault 0
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the current UTC day so far. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
limit- Maximum results, 1 to 100Default 20
offset- Skip the first N results for paginationDefault 0
ticker- Ticker in the path, any case, with or without $, up to 10 characters (TSLA, BRK.A, 7203)
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the last 7 UTC days including today. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
ticker- Ticker in the path, any case, with or without $, up to 10 characters (TSLA, BRK.A, 7203)
q- Ticker or company name, at least 2 characters (required)
limit- Maximum results, 1 to 50Default 20
tickers- Comma-separated tickers, at most 10 (required)
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the last 7 UTC days including today. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the current UTC day so far. At most 30 days back on Free, 90 on Hobby and 365 on Professional; data starts on 2025-06-01
ticker- Ticker in the path, any case, with or without $, up to 10 characters (TSLA, BRK.A, 7203)
from- Inclusive UTC start date (YYYY-MM-DD)
to- Inclusive UTC end date (YYYY-MM-DD). Without a window: the last 7 UTC days including today, at most 365 days back
limit- Maximum rows, 1 to 100Default 50
offset- Skip the first N rowsDefault 0
include_inherited- Also return mentions inherited from the thread contextDefault false
This call takes no parameters.
ticker- Stock ticker symbol
company_name- Company name (null if unknown)
buzz_score- Overall buzz score, 0 to 100
trend- rising, falling or stable: activity in the current 3 UTC days against the previous 3
trend_history- Daily buzz scores, oldest to newest (at least 7 days, 0.0 for days without data)
mentions- Mentions in the window
unique_posts- Distinct posts
subreddit_count- Subreddits with mentions
sentiment_score- Average sentiment, -1 bearish to +1 bullish
bullish_pct- Share of bullish mentions
bearish_pct- Share of bearish mentions
total_upvotes- Upvotes across all mentions
sector- Sector name
buzz_score- Aggregated buzz score, 0 to 100
trend- Activity trend: current 3 UTC days against the previous 3
trend_history- Daily buzz scores, oldest to newest (at least 7 days)
mentions- Mentions across all tickers in the group
unique_tickers- Tickers mentioned
subreddit_count- Subreddits with mentions
sentiment_score- Weighted average sentiment, -1 to +1
bullish_pct- Share of bullish mentions
bearish_pct- Share of bearish mentions
total_upvotes- Upvotes across all mentions
top_tickers- Top 5 tickers by mentions
country- Country name
buzz_score- Aggregated buzz score, 0 to 100
trend- Activity trend: current 3 UTC days against the previous 3
trend_history- Daily buzz scores, oldest to newest (at least 7 days)
mentions- Mentions across all tickers in the group
unique_tickers- Tickers mentioned
subreddit_count- Subreddits with mentions
sentiment_score- Weighted average sentiment, -1 to +1
bullish_pct- Share of bullish mentions
bearish_pct- Share of bearish mentions
total_upvotes- Upvotes across all mentions
top_tickers- Top 5 tickers by mentions
ticker- Stock ticker symbol
company_name- Company name (null if unknown)
found- Whether mentions were found
buzz_score- Overall buzz score, 0 to 100
trend- rising, falling or stable
mentions- Mentions in the window
sentiment_score- Average sentiment, -1 to +1
bullish_pct- Share of bullish mentions
bearish_pct- Share of bearish mentions
total_upvotes- Upvotes across all mentions
unique_posts- Distinct posts
subreddit_count- Subreddits with mentions
period_days- Days in the window
daily_trend- One row per day: date, mentions, sentiment_score, buzz_score, bullish_pct, bearish_pct
top_subreddits- Subreddits with their mentions, sentiment and buzz score
top_mentions- Top mentions by upvotes with snippet, sentiment, subreddit and time
positive_count, negative_count, neutral_count- Legacy counts; use bullish_pct and bearish_pct
ticker- Stock ticker symbol
company_name- Company name (null if unknown)
explanation- One sentence on why the stock is trending
cached- Whether the answer came from the cache
generated_at- When the explanation was written (ISO timestamp)
model- Language model used (null if unavailable)
query- The search query
count- Number of results
period_days- Fixed 7-day window of the summaries
results- Matches with ticker, name, type, exchange, sector, country and aliases
results[].summary- Mentions, buzz_score, trend and sentiment_score over the last 7 UTC days
period_days- Days in the window
stocks- One row per ticker: company_name, buzz_score, trend, mentions, unique_posts, subreddit_count, sentiment_score, bullish_pct, bearish_pct, total_upvotes
buzz_score- Reddit market heat against the trailing 90-day baseline (about 50 is normal)
trend- Activity trend of the whole service
mentions- Stock mentions in the window
unique_posts- Distinct posts
subreddit_count- Subreddits contributing
total_upvotes- Upvotes across all mentions
active_tickers- Tickers active in the window
sentiment_score- Average sentiment, -1 to +1
positive_count, negative_count, neutral_count- Legacy counts; use bullish_pct and bearish_pct
bullish_pct- Share of bullish mentions
bearish_pct- Share of bearish mentions
trend_history- Daily market buzz, oldest to newest
drivers- Tickers driving the current mood
ticker- Resolved ticker
period_days- Applied window
count- Matching rows before the limit
results- Rows with post_id, comment_id, subreddit, author, text_snippet, created_utc, upvotes, sentiment_score, sentiment_label, is_inherited
total_mentions- Mentions stored since the start of the dataset
unique_tickers- Tickers with at least one mention
mentions_today- Mentions of the current UTC day so far
unique_tickers_today- Tickers mentioned today
supported_tickers- Tickers the API can resolve