Data Dictionary
Social Followers

Social Followers

Daily audience counts across 9 platforms: follower or subscriber counts on a company-linked account, plus Stocktwits, which counts cashtag watchers and needs no mapped handle. All metrics are returned by the GET /api/social/{platform}/{ticker} endpoints as part of the SocialDataPoint schema under the unified followers key; see the API Reference for the full schema and per-platform availability matrix.

Follower metrics are level snapshots collected once per day. Each data point represents the total cumulative follower count at the time of collection, not a daily delta. For collection frequency and history start dates, see Collection & Freshness.


Platform-Specific Mapping

All platforms use the unified followers response key. This table shows the metric description for each platform:

PlatformResponse FieldDescription
InstagramfollowersFollower count
FacebookfollowersPage like count
X (Twitter)followersFollower count
ThreadsfollowersFollower count
TikTokfollowersFollower count
PinterestfollowersFollower count
YouTubefollowersSubscriber count
RedditfollowersSubreddit member count
StocktwitsfollowersCashtag watcher count

Variable Definitions

Variable NameTypeAllowed ValuesDefinitionDescription
followers (Instagram)integerNon-negative integerThe total number of Instagram accounts following the entity's official Instagram profileCollected as a daily snapshot from the entity's public Instagram profile. Mapped via the entity's instagram handle in the Knowledge Graph. History begins 2018-10-30.
followers (X)integerNon-negative integerThe total number of X (formerly Twitter) accounts following the entity's official X profileCollected as a daily snapshot from the entity's public X profile. Mapped via the entity's x handle in the Knowledge Graph. History begins 2020-10-25. Available for ~2,165 companies.
followers (Facebook)integerNon-negative integerThe total number of fans (page likes) on the entity's official Facebook pageReturned as followers in the API. Represents Facebook page likes ("people who like this"). Mapped via the entity's facebook page ID in the Knowledge Graph. History begins 2020-11-07. Available for ~1,841 companies.
followers (Threads)integerNon-negative integerThe total number of Threads accounts following the entity's official Threads profileThreads is Meta's text-based social platform. Mapped via the entity's threads handle in the Knowledge Graph. History begins 2023-07-06.
followers (TikTok)integerNon-negative integerThe total number of TikTok accounts following the entity's official TikTok profileCollected as a daily snapshot. Mapped via the entity's tiktok handle in the Knowledge Graph. History begins 2021-02-21. Currently mapped for ~286 companies, primarily consumer-facing brands.
followers (Pinterest)integerNon-negative integerThe total number of Pinterest accounts following the entity's official Pinterest profileCollected as a daily snapshot. Mapped via the entity's pinterest handle in the Knowledge Graph. History begins 2021-11-09.
followers (YouTube)integerNon-negative integerThe total number of YouTube accounts subscribed to the entity's official YouTube channelReturned as followers in the API. YouTube may round counts for large channels. Mapped via the entity's youtube channel in the Knowledge Graph. History begins 2020-04-05. Available for ~1,422 companies.
followers (Reddit)integerNon-negative integerThe total number of Reddit accounts subscribed to the entity's official or primary subredditReturned as followers in the API. Represents the subreddit's member count. Mapped via the entity's reddit subreddit name in the Knowledge Graph. History begins 2018-10-30. Currently mapped for ~173 companies.
followers (Stocktwits)integerNon-negative integerThe number of Stocktwits users watching the entity's cashtagReturned as followers in the API. This is a watcher count on the symbol rather than a follower count on an account, so it needs no handle mapping: Stocktwits is keyed by cashtag (the ticker itself) and coverage spans essentially the whole active catalog. History begins 2021-05-13.

All platforms return audience size under the unified followers key. Facebook page likes, YouTube and Reddit subscriber counts, and Stocktwits cashtag watchers are all included under this field for consistent cross-platform comparison. They are not the same kind of quantity, so treat each as a within-platform time series rather than comparing absolute values across platforms.


Common Characteristics

All follower variables share these properties:

  • Nullable: Field is omitted from the response when no data is available for a given date
  • Monotonic tendency: Follower counts generally increase over time but can decrease (unfollows, account purges, platform corrections)
  • Levels, not changes: Each value is an absolute count, not a daily change -- compute deltas by differencing consecutive days
  • Time zone: Daily snapshots use America/Los_Angeles day boundaries (see Collection & Freshness)
  • Platform dependency: A value is only available if the entity has a mapped handle for that platform (check via GET /api/entities/{ticker})