Categorized Social Volume
Notice: These metrics are currently available via API only. Sanbase support is coming soon.
Definition
Twitter/X.com Social Volume can be broken down by account category.
Categorized Social Volume ships as a set of per-category metrics, each following the pattern social_volume_twitter_<category>.
Each metric counts social data text documents posted by accounts in a defined category that mention the given asset. Document-counting mechanic (tweets/replies, “posted by” attribution) is carried over from how Social Volume counts documents.
See Categorized Social Volume Details for what accounts fall into each category, how assignment works, and how often it is reviewed.
Like Social Volume, data for these metrics may be supplemented with new data within a 12-hour period after it is first recorded.
These metrics are currently in beta status.
Access
As of this writing, these metrics are available only to alpha and beta users. Every other account gets the following error for every asset, whatever its subscription plan, Business Max included:
The metric social_volume_twitter_kol is currently in beta phase and is exclusively available to alpha and beta users.
getAccessRestrictions still shows these metrics as isAccessible: true for paid plans, because it does not account for the beta restriction.
Measuring Unit
Amount of documents posted by accounts in the category that mention the given asset.
Data Type
Change Metrics
No _change_1d, _change_7d, or _change_30d variants exist for these metrics.
Frequency
Latency
Available Assets
Available for these assets.
All seven category metrics share the same 215-asset set, which is a subset of the 2,816 assets available for Social Volume.
SanAPI
Available under the following names:
- social_volume_twitter_btc_maxi
- social_volume_twitter_builder
- social_volume_twitter_kol
- social_volume_twitter_media
- social_volume_twitter_memecoins
- social_volume_twitter_trader
- social_volume_twitter_trading_firm
Categorized Social Volume for an Asset
{ getMetric(metric: "social_volume_twitter_btc_maxi") { timeseriesDataJson( selector: { slug: "bitcoin" } from: "2025-09-01T00:00:00Z" to: "2025-09-07T00:00:00Z" interval: "1d" ) }}As of this writing, this query returns the beta-access error described under Access instead of data.
Full List of Metrics
The full list of Categorized Social Volume metrics is:
Open Metrics List
- social_volume_twitter_btc_maxi
- social_volume_twitter_builder
- social_volume_twitter_kol
- social_volume_twitter_media
- social_volume_twitter_memecoins
- social_volume_twitter_trader
- social_volume_twitter_trading_firm