Mentions & Sentiment
Mention counts and sentiment scores derived from public discussion data across Reddit, X (Twitter), and Stocktwits, available via the GET /api/social/{platform}/{ticker} endpoints as part of the SocialDataPoint schema; see the API Reference for the full schema.
Unlike follower metrics (which are level snapshots), mention and sentiment values are daily aggregates -- they represent activity that occurred during a single calendar day. For collection frequency and history start dates, see Collection & Freshness.
Mention and sentiment coverage is not limited by handle mapping. These metrics are collected by keyword across each platform, not by reading an entity's own account or community. So an entity with a null reddit or x handle in the Knowledge Graph still returns mentions and sentiment data, and a null handle in a response never implies missing data. (Dates with no activity are omitted either way, so a gap is not evidence of handle gating.)
Handle mapping only limits the audience metrics on Social Followers: a subscriber or follower count needs an account to count, so those are the fields that require a mapped handle. Stocktwits is the exception even there, since it is keyed by cashtag and needs no handle at all.
Platform Availability
Not all platforms provide both mentions and sentiment. This table shows which metrics are available for each source:
| Platform | mentions | sentiment |
|---|---|---|
| Yes | Yes | |
| Stocktwits | Yes | Yes |
| X (Twitter) | Yes | Yes |
Mention Count Variables
Mention counts represent the number of times an entity was referenced in public discussions during a single calendar day.
| Variable Name | Type | Allowed Values | Definition | Description |
|---|---|---|---|---|
mentions (Reddit) | integer | Non-negative integer | The number of Reddit posts and comments mentioning the entity on a given day | Aggregated from posts and comments across major investing and finance subreddits (e.g., r/wallstreetbets, r/stocks, r/investing). Mentions are matched by keyword using the entity's ticker symbol, cashtag, and known aliases from the Knowledge Graph, not by reading a company's own subreddit, so coverage does not depend on whether the entity has a reddit handle mapped. History begins 2021-02-25. Ingested intraday with a daily aggregate rolled up at end-of-day. |
mentions (Stocktwits) | integer | Non-negative integer | The number of Stocktwits messages mentioning the entity's cashtag on a given day | Aggregated from public Stocktwits posts containing the entity's cashtag (e.g., $AAPL). Mention volumes tend to correlate with market activity and trading volume. History begins 2021-09-16. Collected as a daily aggregate. |
mentions (X) | integer | Non-negative integer | The number of X (formerly Twitter) posts mentioning the entity's cashtag on a given day | Aggregated from public posts on X containing the entity's cashtag (e.g., $TSLA). Cashtag-based matching ensures relevance to financial discussion rather than general brand mentions, and because it is keyword-based rather than read from the company's own account, coverage does not depend on whether the entity has an x handle mapped. History begins 2025-09-24. Ingested intraday with a daily aggregate rolled up at end-of-day. |
Interpreting mention counts across platforms: Absolute mention counts are not directly comparable across platforms due to differences in user base size, posting conventions, and matching methodology. Use mentions as a within-platform time-series signal (e.g., "Reddit mentions for TSLA spiked 3x vs. its 30-day average") rather than comparing raw counts across platforms.
Sentiment Score Variables
Sentiment scores quantify the overall tone of public discussion about an entity on a given day. Higher values indicate more positive sentiment.
| Variable Name | Type | Allowed Values | Definition | Description |
|---|---|---|---|---|
sentiment (Reddit) | integer | 0 -- 100 | A score representing the aggregate sentiment of Reddit posts and comments mentioning the entity on a given day | Scored with a fixed financial-sentiment word list applied to Reddit posts and comments, then averaged per day. 0 is maximally negative, 50 is neutral, 100 is maximally positive. Computed over the same corpus used for mention counts. The underlying signal is a 0.0 -- 1.0 score which the API rescales to 0 -- 100 so every platform reports sentiment on one scale. History begins 2021-02-25. |
sentiment (Stocktwits) | integer | 0 -- 100 | A score representing the aggregate sentiment of Stocktwits messages about the entity on a given day | Derived from Stocktwits' native bull/bear tagging system, where users self-label posts as "Bullish" or "Bearish". The value is the bullish share of that day's self-labelled posts: 0 is entirely bearish, 100 is entirely bullish, 50 is an even split. Community-driven signal, not text analysis. History begins 2021-09-16. |
sentiment (X) | integer | 0 -- 100 | A score representing the aggregate sentiment of X posts mentioning the entity's cashtag on a given day | Scored with the same fixed financial-sentiment word list as Reddit, applied to public X posts containing the entity's cashtag and averaged per day. 0 is maximally negative, 50 is neutral, 100 is maximally positive. History begins 2025-09-24. |
Every platform returns sentiment as an integer from 0 to 100, so no rescaling is needed to compare them. Reddit's underlying score is computed on a 0.0 -- 1.0 scale and the API multiplies it by 100 before returning it; if you also read the raw dataset directly, expect the 0.0 -- 1.0 form there.
What is not comparable is how each score is produced. Reddit and X are scored by a fixed financial-sentiment word list applied to post text, while Stocktwits comes from users self-labelling their own posts "Bullish" or "Bearish". A Stocktwits 60 and a Reddit 60 are the same number measuring different things.
Shared Response Fields
| Variable Name | Type | Allowed Values | Definition | Description |
|---|---|---|---|---|
date | date | ISO 8601 (YYYY-MM-DD) | The calendar date the aggregate covers | Represents a full calendar day using America/Los_Angeles day boundaries. The value reflects activity that occurred during this day. See Time Conventions. |
Common Characteristics
All mention and sentiment variables share these properties:
- Nullable: Fields are omitted from the response when no data is available for a given date
- Daily aggregates: Unlike follower snapshots, these values represent activity within a single day and are not cumulative
- Zero vs. absent: A value of
0means the entity was tracked but had no mentions; an absent field means the metric is not available for that platform or date - Time zone: Daily aggregates use
America/Los_Angelesday boundaries (see Collection & Freshness) - Backfill policy: Expect occasional backfills and corrections -- the newest processed aggregate value is authoritative