Postpone Logo
Analytics

Post Tag Metrics

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

The postTagMetrics query returns analytics data aggregated by post tags, allowing you to analyze performance based on how you've categorized your content.

Query

query postTagMetrics(
  $startDate: DateTime!
  $endDate: DateTime!
  $supportsEngagementRate: Boolean
) {
  postTagMetrics(
    startDate: $startDate
    endDate: $endDate
    supportsEngagementRate: $supportsEngagementRate
  ) {
    postTag {
      id
      name
      color
    }
    metrics {
      metric
      value
      aggregation
    }
  }
}

Parameters

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.
supportsEngagementRate
Boolean
Whether to include engagement rate calculations in the metrics. Default: false. When enabled, the query calculates engagement rate where applicable.

Response Structure

The response includes an array of results, one per post tag used during the time period. Each result contains:

  • postTag: Details about the tag including ID, name, and color
  • metrics: An array of metric values aggregated across all posts with this tag

For each metric, you'll receive:

  • sum: The total count across all posts with this tag
  • avg: The average value per post with this tag

The posts metric shows how many posts were tagged with this tag during the period.

Metrics Returned

The query automatically includes relevant metrics based on the platforms where tagged posts were published:

Core Metrics (All Platforms)

  • posts: Number of posts with this tag
  • likes: Total and average likes (or platform equivalent)
  • comments: Total and average comments (or platform equivalent)

Platform-Specific Metrics

Depending on which platforms your tagged posts were published to, you may also see:

  • impressions: Total impressions (Instagram, Twitter, Facebook, LinkedIn, TikTok)
  • views: Total views (TikTok, YouTube, Threads)
  • shares: Total shares (Instagram, TikTok, Facebook)
  • reach: Total reach (Instagram, Facebook)
  • engagement_rate: Average engagement rate (when supportsEngagementRate is enabled)
The metrics returned are automatically determined by the platforms where your tagged posts were published. This query aggregates data across all platforms.

Understanding Engagement Rate

When supportsEngagementRate is set to true, the query includes an engagement rate calculation. The engagement rate is calculated as:

(likes + comments + shares) / impressions × 100

This metric is only calculated for platforms that provide impression data.

Examples

Compare Content Categories

Analyze which types of content perform best:

{
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-03-31T23:59:59Z",
  "supportsEngagementRate": true
}

Quarterly Campaign Analysis

Review performance of different campaign tags over a quarter:

{
  "startDate": "2025-07-01T00:00:00Z",
  "endDate": "2025-09-30T23:59:59Z",
  "supportsEngagementRate": false
}

Monthly Content Review

Get monthly metrics to inform your content strategy:

{
  "startDate": "2025-10-01T00:00:00Z",
  "endDate": "2025-10-31T23:59:59Z",
  "supportsEngagementRate": true
}

Year-End Report

Generate an annual report showing which content tags performed best:

{
  "startDate": "2025-01-01T00:00:00Z",
  "endDate": "2025-12-31T23:59:59Z",
  "supportsEngagementRate": true
}

Use Cases

This query is ideal for:

  • Content Strategy: Identify which content categories resonate most with your audience
  • Campaign Analysis: Compare performance across different campaign types
  • Topic Performance: Discover which topics generate the most engagement
  • Content Planning: Use historical tag performance to inform future content plans
  • ROI Tracking: Measure the effectiveness of different content themes
  • Team Reporting: Show content team which themes are performing best

Working with Post Tags

Post tags are created and managed in your Postpone account. To use this query effectively:

  1. Tag your posts consistently: Apply tags to posts as you create them
  2. Use meaningful names: Choose tag names that reflect content categories or campaigns
  3. Organize by theme: Group related content under the same tags
  4. Review regularly: Use this query periodically to inform your content strategy
Post tags are account-wide, meaning this query automatically includes data from all your social accounts across all platforms. This gives you a holistic view of how different content types perform regardless of where they're posted.

Aggregate Social Account Post Metrics

Retrieve aggregated post metrics for multiple social accounts, broken down by account.

Multi-Platform Analytics Submissions

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