Social Volume
Definition
Social Volume is build on top of the Social Data.
The total number of social data text documents that
contain the given search term at least once. Examples of documents are telegram
messages and reddit posts. If a single short telegram message includes the word
crypto
more than once, this message will increase the social volume of the
word crypto
by 1. If a long reddit post contains the word crypto
10 times,
this again will increase the social volume of the word crypto
by 1.
Social Volume can be computed for an asset or for arbitrary
search terms. When an asset is used, a special search term is constructed. For
example querying the social volume for santiment
will result in a search term
similar to:
(SAN OR santiment OR santoken OR santimentnet OR sancoin OR sansan OR sancoin) AND NOT ((san AND francisco) OR (san AND fran) OR (san AND diego) OR (san AND marino) OR (san AND jose))
which includes documents containg santiment
or san
but excludes documents
that contain common phrases containing san
like San Francisco
.
The arbitrary search term can be:
- One particular word like
bitcoin
,crypto
orblockchain
. - An exact phrase (surrounded by double quotation marks) like
"when moon"
,"buy high sell low"
or"btc rekt"
. Lucene Query - a search term that allows for logical operators. Examples:
OR
- The union of two search results.btc OR bitcoin
returns the documents that contain at least one of the wordsbtc
andbitcoin
AND
- The intersection of two search results.btc AND moon
returns the documents that contain both of the wordsbtc
andmoon
at the same time.NOT
- Filter out documents that contain a given search term.btc NOT lambo
returns the documents that contain the wordbtc
and does not contain the wordlambo
?
- A wildcard search.?
in the search term means that it can match any character. For example the querybtc AND 1?k
will be the combined result ofbtc AND 10k
,btc AND 11k
, ...,btc AND 19k
(but also nonsense likebtc AND 1sk
,btc AND 1Ak
, etc. will be matched)- Many other operators can be used, documentation for which can be found in the lucene query syntax documentation.
The operators can be combined and higher precedence can be expressed by using
parentheses (btc OR bitcoin) AND moon NOT lambo
- it will result in all the
documents that contain either the words btc
and moon
or the words bitcoin
and moon
in one document, excluding any documents that contain the word
lambo
.
Please note that metrics may undergo changes in historical values due to automated recalculations triggered monthly. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data.
Access
Measuring Unit
Amount of documents that mention the given text pattern.
Data Type
Change Metrics
Frequency
Latency
Available Assets
Available for these assets
Note:
social_volume_total
metric and all metrics for a specific source are available for the same set of assets.
Sanbase
Combined Social Volume from all sources for an asset can be seen on a project's page.
Social Volume for arbitrary search terms can be viewed from the trends page
The combined social volume from all sources is displayed. From the bottom of the page social volume for a specific source can be displayed, too.
SanAPI
Available under the social_volume_total
and social_volume_total_<source>
names, where the available sources are:
- 4chan
- telegram
- bitcointalk
- youtube_videos
- farcaster
- total (combines all sources)
Social Volume for an asset
1 2 3 4 5 6 7 8 9 10 11 12 13
{ getMetric(metric: "social_volume_total") { timeseriesData( selector: { slug: "santiment" } from: "2020-01-01T00:00:00Z" to: "2020-01-07T00:00:00Z" interval: "1d" ) { datetime value } } }
Social Volume for arbitrary search term
1 2 3 4 5 6 7 8 9 10 11 12 13
{ getMetric(metric: "social_volume_telegram") { timeseriesData( selector: { text: "btc AND 1?k" } from: "2020-01-01T00:00:00Z" to: "2020-01-07T00:00:00Z" interval: "1d" ) { datetime value } } }
Full list of metrics
The full list of Social Volume metrics is:
Open Metrics List
Open Metrics List
- social_volume_4chan
- social_volume_bitcointalk
- social_volume_reddit
- social_volume_telegram
- social_volume_total
- social_volume_twitter
- social_volume_youtube_videos
- social_volume_farcaster
Open Change Metrics List
Open Change Metrics List
- social_volume_total_change_1d
- social_volume_total_change_30d
- social_volume_total_change_7d
Talk to us in Discord
Still have some questions left? Join our Discord and get help from the Santiment team!
Go to Discord