First, read through our API introduction article for info on how to work with our API playground and make API calls.

Time-Series Data

To retrieve time-series data for your posts, query the postTimeSeriesMetrics field:

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

The following is an example of input to pass to this field:

{
  "socialAccountIds": [1],
  "startDate": "2025-01-01T00:00:00.000Z",
  "endDate": "2025-03-01T00:00:00.000Z",
  "metrics": ["likes", "replies", "views"],
  "groupBy": "week"
}

Platform Metrics

Each platform has its own metrics you can query. Below is each metric value for each platform Postpone supports:

Reddit

1. upvotes
2. comments

Instagram

1. likes
2. comments
3. follows
4. impressions
5. shares
6. profile_activity
7. profile_visits
8. total_interactions
9. reach

Twitter

1. likes
2. replies
3. retweets
4. quote_tweets
5. impressions
6. url_link_clicks
7. user_profile_clicks

Threads

1. likes
2. replies
3. views
4. reposts
5. quotes
6. shares

Facebook

1. likes
2. comments
3. impressions
4. impressions_unique
5. engaged_users
6. engaged_fan
7. video_views
8. clicks
9. clicks_unique

TikTok

1. likes
2. comments
3. shares
4. impressions

LinkedIn

1. likes
2. comments
3. impressions

YouTube Shorts

1. likes
2. dislikes
3. comments
4. views
5. favorites

Bluesky

1. likes
2. replies
3. reposts
4. quotes

Tumblr

1. notes

Mastodon

1. likes
2. replies
3. reposts

Pinterest

Dude to platform limitations, Pinterest does not support analytics at this time.