Postpone Logo
Analytics

Multi-Platform Analytics Submissions

Retrieve and search individual post submissions across multiple platforms with detailed metrics.

The multiPlatformAnalyticsSubmissions query returns a paginated list of individual post submissions with their associated metrics. This query supports searching, filtering, and sorting across all platforms simultaneously.

Query

query multiPlatformAnalyticsSubmissions(
  $socialAccountIds: [ID]
  $clientId: ID
  $startDate: DateTime!
  $endDate: DateTime!
  $query: String
  $page: Int
  $limit: Int
  $orderBy: SubmissionAnalyticsOrderingType
) {
  multiPlatformAnalyticsSubmissions(
    socialAccountIds: $socialAccountIds
    clientId: $clientId
    startDate: $startDate
    endDate: $endDate
    query: $query
    page: $page
    limit: $limit
    orderBy: $orderBy
  ) {
    total
    objects {
      platformId
      dateSubmitted
      socialAccount {
        id
        username
        formattedUsername
        avatarUrl
        platform
      }
      text
      thumbnailUrl
      url
      target
      metrics {
        metric
        value
      }
      postTags {
        id
        name
        color
      }
    }
  }
}

Parameters

socialAccountIds
[ID]
Filter submissions to specific social accounts. If omitted, includes all accounts you have access to. See how to retrieve your social accounts.
clientId
ID
Filter submissions to social accounts belonging to a specific client (for agency users).
startDate
DateTime required
The start date for submissions. Only posts submitted after this date will be included. Must be in ISO 8601 format.
endDate
DateTime required
The end date for submissions. Only posts submitted before this date will be included. Must be in ISO 8601 format.
query
String
Search term to filter submissions by text content. Searches the post text/caption for matches (case-insensitive).
page
Int
The page number for pagination. Default: 1.
limit
Int
The number of submissions per page. Default: 100. Maximum: 100.
orderBy
SubmissionAnalyticsOrderingType
How to sort the results. Default: DATE_SUBMITTED_DESC. See Sorting Options below.

Sorting Options

The orderBy parameter accepts the following values:

  • DATE_SUBMITTED_ASC - Oldest first
  • DATE_SUBMITTED_DESC - Newest first (default)
  • LIKES_ASC - Least likes first
  • LIKES_DESC - Most likes first
  • REPLIES_ASC - Least replies/comments first
  • REPLIES_DESC - Most replies/comments first
  • VIEWS_ASC - Least views first
  • VIEWS_DESC - Most views first
  • REPOSTS_ASC - Least reposts/retweets first
  • REPOSTS_DESC - Most reposts/retweets first
  • QUOTES_ASC - Least quotes first
  • QUOTES_DESC - Most quotes first
  • SHARES_ASC - Least shares first
  • SHARES_DESC - Most shares first
  • CLICKS_ASC - Least clicks first
  • CLICKS_DESC - Most clicks first
  • PROFILE_CLICKS_ASC - Least profile clicks first
  • PROFILE_CLICKS_DESC - Most profile clicks first
  • REACH_ASC - Least reach first
  • REACH_DESC - Most reach first
  • TOTAL_ENGAGEMENTS_ASC - Least total engagements first
  • TOTAL_ENGAGEMENTS_DESC - Most total engagements first
  • ENGAGEMENT_RATE_ASC - Lowest engagement rate first
  • ENGAGEMENT_RATE_DESC - Highest engagement rate first
When sorting by a metric that isn't available for a platform (e.g., sorting by VIEWS_DESC when including Twitter posts), those submissions will be ordered as if the value is 0.

Response Structure

The response includes:

  • total: The total number of submissions matching your filters (across all pages)
  • objects: An array of submission objects for the current page

Each submission object includes:

  • platformId: The unique ID from the platform (e.g., Instagram post ID, Tweet ID)
  • dateSubmitted: When the post was published
  • socialAccount: Details about the account that published the post
  • text: The post text/caption
  • thumbnailUrl: URL to a thumbnail image (if available)
  • url: Direct link to the post on the platform
  • target: The target destination (e.g., subreddit name for Reddit posts)
  • metrics: Array of metric values specific to the platform
  • postTags: Array of tags applied to this post

Examples

Find Top Performing Posts

Get the top 10 posts by likes across all accounts:

{
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-12-31T23:59:59Z",
  "limit": 10,
  "orderBy": "LIKES_DESC"
}

Search Product Mentions

Find all posts mentioning a specific product:

{
  "socialAccountIds": ["123", "456"],
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-03-31T23:59:59Z",
  "query": "iPhone 15",
  "limit": 50,
  "orderBy": "DATE_SUBMITTED_DESC"
}

Client Monthly Report

Generate a report of all posts for a specific client:

{
  "clientId": "client-001",
  "startDate": "2025-10-01T00:00:00Z",
  "endDate": "2025-10-31T23:59:59Z",
  "limit": 100,
  "orderBy": "DATE_SUBMITTED_DESC"
}

Analyze High Engagement Posts

Find posts with the highest engagement rate to analyze what works:

{
  "socialAccountIds": ["123", "456", "789"],
  "startDate": "2025-06-01T00:00:00Z",
  "endDate": "2025-08-31T23:59:59Z",
  "limit": 25,
  "orderBy": "ENGAGEMENT_RATE_DESC"
}

Export All Posts Data

Paginate through all posts to export data:

{
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-12-31T23:59:59Z",
  "page": 1,
  "limit": 100,
  "orderBy": "DATE_SUBMITTED_DESC"
}

Post Tag Metrics

Retrieve aggregated analytics metrics for your posts grouped by post tags.

Platform Metrics

Available analytics metrics for each social media platform.