Analytics

Post Time Series Metrics

Retrieve time-series analytics data for your social media posts grouped by date.

The postTimeSeriesMetrics query returns analytics metrics for posts over time, allowing you to track performance trends and patterns across different time periods.

Query

query postTimeSeriesMetrics(
  $socialAccountIds: [ID]
  $startDate: DateTime!
  $endDate: DateTime!
  $metrics: [String]
  $groupBy: String
  $subreddits: [String]
) {
  postTimeSeriesMetrics(
    socialAccountIds: $socialAccountIds
    startDate: $startDate
    endDate: $endDate
    metrics: $metrics
    groupBy: $groupBy
    subreddits: $subreddits
  ) {
    date
    isoWeek
    isoYear
    metrics {
      metric
      value
    }
  }
}

{
  "socialAccountIds": ["123", "456"],
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-01-31T23:59:59Z",
  "metrics": ["likes", "comments", "impressions", "posts"],
  "groupBy": "week"
}

{
  "data": {
    "postTimeSeriesMetrics": [
      {
        "date": "2025-01-01T00:00:00Z",
        "isoWeek": 1,
        "isoYear": 2024,
        "metrics": [
          {
            "metric": "likes",
            "value": 1250
          },
          {
            "metric": "comments",
            "value": 84
          },
          {
            "metric": "impressions",
            "value": 15300
          },
          {
            "metric": "posts",
            "value": 12
          }
        ]
      },
      {
        "date": "2025-01-08T00:00:00Z",
        "isoWeek": 2,
        "isoYear": 2024,
        "metrics": [
          {
            "metric": "likes",
            "value": 1890
          },
          {
            "metric": "comments",
            "value": 102
          },
          {
            "metric": "impressions",
            "value": 18650
          },
          {
            "metric": "posts",
            "value": 15
          }
        ]
      }
    ]
  }
}

Parameters

socialAccountIds

[ID]

An array of social account IDs to retrieve metrics for. All accounts must be from the same platform. See how to retrieve your social accounts.

startDate

DateTime required

The start date for the analytics period. Must be in ISO 8601 format.

endDate

DateTime required

The end date for the analytics period. Must be in ISO 8601 format.

metrics

[String]

An array of metric names to retrieve. Available metrics vary by platform. See Available Metrics below.

groupBy

String

How to group the time series data. Options: "day", "week", "month". Default: "week".

subreddits

[String]

Filter metrics by specific subreddits (Reddit only). Pass subreddit names without the "r/" prefix.

Available Metrics

The available metrics depend on the platform of your social accounts. See the Platform Metrics documentation for a complete list of metrics available for each platform.

All social accounts in a single query must be from the same platform. To retrieve metrics for multiple platforms, make separate queries.

Examples

Track Weekly Instagram Performance

{
  "socialAccountIds": ["789"],
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-03-31T23:59:59Z",
  "metrics": ["likes", "comments", "impressions", "reach"],
  "groupBy": "week"
}

Daily TikTok Metrics for Multiple Accounts

{
  "socialAccountIds": ["101", "102", "103"],
  "startDate": "2025-10-01T00:00:00Z",
  "endDate": "2025-10-31T23:59:59Z",
  "metrics": ["likes", "views", "shares"],
  "groupBy": "day"
}

Reddit Performance by Subreddit

{
  "socialAccountIds": ["456"],
  "subreddits": ["gaming", "pcmasterrace", "buildapc"],
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-01-31T23:59:59Z",
  "metrics": ["upvotes", "comments", "posts"],
  "groupBy": "week"
}

Introduction

Query analytics data and performance metrics for your social media posts.

Aggregate Post Metrics

Retrieve aggregated analytics metrics for your social media posts across a time period.