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