Social Data Versions

Santiment social metrics support versioning. A version identifies the underlying dataset and methodology used to calculate a social metric. This makes it possible to work with multiple interpretations of the same metric without changing the metric name itself.

Social-data versioning serves three purposes:

• Audience-specific datasets. Different versions can analyze different sets of accounts, enabling metrics tailored to a specific social audience.
• Processing methodology. Versions can represent alternative technical approaches to collecting or processing social data.
• Point-in-time (PIT) data. PIT versions support historically accurate analysis by using the dataset state that would have been available at each point in time.

Choose the version deliberately. Data from different versions may differ because their account universe, processing logic, or historical availability rules are different. Avoid comparing values across versions as though they were generated by one identical dataset.

Specify the desired version through the version argument of getMetric. The metric name remains unchanged; only the dataset version changes.

For example, the query below retrieves social_volume_twitter for Bitcoin from both the modern dataset and its PIT counterpart over the same two-hour interval.

1
{
2
  modern: getMetric(
3
    metric: "social_volume_twitter",
4
    version: "modern:v1"
5
  ) {
6
    timeseriesDataJson(
7
      slug: "bitcoin"
8
      from: "utc_now-2h"
9
      to: "utc_now"
10
      interval: "5m"
11
    )
12
  }
13

14
  modernPit: getMetric(
15
    metric: "social_volume_twitter",
16
    version: "modern_pit:v1"
17
  ) {
18
    timeseriesDataJson(
19
      slug: "bitcoin"
20
      from: "utc_now-2h"
21
      to: "utc_now"
22
      interval: "5m"
23
    )
24
  }
25
}

Not every version is available on every plan. See Version Access by Plan.

Use the original version when your analysis needs the long-running social dataset maintained since 2021, including long-standing crypto-market participants.

Use the modern version when you want to measure engagement among currently active Crypto Twitter users.

Use the PIT version for historical research, backtesting, or any workflow where data must reflect what was available at the time rather than a later revised dataset.

For a single analysis, dashboard, or backtest, keep the version consistent across all queries and time ranges unless you intentionally want to study methodological differences.

For general information about metric versions, see Metric Versions.