Top Social Gainers / Losers metric

Definition

This returns the projects that have gained or lost the most Social Volume over the given time window.

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.

Measuring Unit

The change is measured in absolute social volume difference

Access

Data Type

Timeseries Data

Frequency

Hourly Intervals

Latency

Social Data Latency

SanAPI

The metric is fetched with the topSocialGainersLosers query.

Arguments description:

• status - one of the following (these are not Strings!):

  • `ALL - shows all of the below
  • GAINER - shows only top gainers
  • LOSER - shows only top losers
  • NEWCOMER - show projects that had no social volume before

• timeWindow - number of days that are taken into account, between "2d" and "30d"

• size - the length of the Trending Words list
• from - a string representation of datetime value according to the iso8601 standard, e.g. "2018-04-16T10:02:19Z"
• to - a string representation of datetime value according to the iso8601 standard, e.g. "2018-04-16T10:02:19Z"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  topSocialGainersLosers(
    from: "2019-05-09T11:25:04.894Z"
    to: "2019-06-23T11:25:04.894Z"
    size: 5
    status: ALL
    timeWindow: "2d"
  ) {
    datetime
    projects {
      slug
      status
      change
    }
  }
}

Run in explorer