Labeled Social Volume
Definition
Labeled Social Volume splits Social Volume by document sentiment score. Each document is labeled positive, neutral, or negative, then counted.
A document is:
- Positive when
sentiment.positive > 0.55. - Neutral when
0.45 ≤ sentiment.positive ≤ 0.55andsentiment.positive != 0.5. Documents scored exactly0.5are excluded as noise. - Negative when
sentiment.negative > 0.55orsentiment.positive < 0.45.
These metrics are currently in beta status.
Access
As of this writing, the SanAPI returns the following error for every asset covered by these metrics, regardless of subscription tier:
The metric
positive_docs_count_totalis currently in beta phase and is exclusively available to alpha and beta users.
Measuring Unit
Amount of documents that fall into the given sentiment bucket.
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.
SanAPI
Available under the positive_docs_count_total and positive_docs_count_<source>, neutral_docs_count_total and neutral_docs_count_<source>, negative_docs_count_total and negative_docs_count_<source> names, where the available sources are:
- 4chan
- telegram
- total (combines all sources)
Documents Count by Sentiment for an Asset
{ getMetric(metric: "positive_docs_count_total") { timeseriesDataJson( selector: { slug: "bitcoin" } from: "2026-01-01T00:00:00Z" to: "2026-01-15T00:00:00Z" interval: "1d" ) }} Full List of Metrics
The full list of Labeled Social Volume metrics is:
Open Positive Docs Count
- positive_docs_count_total
- positive_docs_count_4chan
- positive_docs_count_reddit
- positive_docs_count_telegram
- positive_docs_count_twitter
Open Neutral Docs Count
- neutral_docs_count_total
- neutral_docs_count_4chan
- neutral_docs_count_reddit
- neutral_docs_count_telegram
- neutral_docs_count_twitter
Open Negative Docs Count
- negative_docs_count_total
- negative_docs_count_4chan
- negative_docs_count_reddit
- negative_docs_count_telegram
- negative_docs_count_twitter