Introduction
The Postpone Analytics API provides comprehensive metrics and insights about your social media posts across all connected platforms.
Overview
Our analytics queries allow you to:
- Track performance trends over time with time-series data
- Compare metrics across different platforms and accounts
- Analyze content categories using post tags
- Search and filter individual posts with detailed metrics
- Generate reports with aggregated statistics
Available Queries
Post Time Series Metrics
Retrieve analytics metrics grouped by time periods (day, week, or month) to track performance trends.
Aggregate Post Metrics
Get total and average metrics across a time period for quick performance summaries.
Aggregate Social Account Post Metrics
Compare performance across multiple social accounts with metrics broken down by account.
Post Tag Metrics
Analyze performance by content categories using post tags to identify what resonates.
Platform Support
Analytics are available for all supported platforms:
- Reddit - Upvotes, comments, karma
- X/Twitter - Likes, retweets, replies, impressions, engagement
- Instagram - Likes, comments, impressions, reach, shares
- TikTok - Likes, comments, shares, views
- Threads - Likes, replies, views, reposts, quotes
- Facebook - Likes, comments, impressions, video views, clicks
- LinkedIn - Likes, comments, impressions
- YouTube - Likes, dislikes, comments, views
- Bluesky - Likes, replies, reposts, quotes
- Mastodon - Likes, replies, reposts
- Tumblr - Notes (likes + reblogs + replies)
Key Features
Multi-Platform Support
Most analytics queries support querying multiple platforms simultaneously, making it easy to get a unified view of your performance across all social media channels.
Flexible Time Ranges
All queries accept startDate and endDate parameters, allowing you to analyze any time period. Group data by day, week, or month to match your reporting needs.
Advanced Filtering
Filter your analytics by:
- Social accounts - Query specific accounts or groups of accounts
- Campaigns - Track performance of specific marketing campaigns
- Subreddits - Filter Reddit posts by target communities
- Post tags - Analyze content by category or theme
- Search terms - Find posts containing specific keywords
Rich Metrics
Access comprehensive metrics including:
- Engagement metrics (likes, comments, shares)
- Reach metrics (impressions, views, reach)
- Performance indicators (engagement rate, click-through rate)
- Account growth (followers, subscribers)
Common Use Cases
Performance Dashboards
Use Post Time Series Metrics and Aggregate Post Metrics to build real-time performance dashboards showing trends and KPIs.
Content Strategy
Analyze Post Tag Metrics to discover which content themes perform best and inform your content planning.
Account Comparison
Compare performance across accounts using Aggregate Social Account Post Metrics to identify top performers.
Campaign Reporting
Generate comprehensive campaign reports by filtering queries with campaign IDs and analyzing performance across multiple dimensions.
Content Audit
Use Multi-Platform Analytics Submissions to review individual posts, identify top performers, and discover optimization opportunities.
Analytics History
The amount of historical analytics data available depends on your subscription plan:
- Free Plan: no analytics support
- Starter Plan: 2 months of history
- Creator Plan: 6 months of history
- Professional Plan: 12 months of history
- Agency Plan: Unlimited history
Getting Started
- Connect your accounts: Make sure you have social accounts connected in Postpone
- Post content: Analytics are generated for published posts
- Choose a query: Select the analytics query that matches your needs
- Set time range: Specify your desired start and end dates
- Request metrics: Specify which metrics you want to retrieve
Best Practices
Optimize Query Performance
- Request only the metrics you need
- Use appropriate time ranges for your use case
- Cache results when possible to reduce API calls
- Use pagination for large result sets
Data Freshness
Analytics data is updated every 4-12 hours depending on the platform, except for X/Twitter, where data is updated twice (2 days and 7 days after post submission).
Additionally, all platforms except for X/Twitter include posts submitted from outside of Postpone in Analytics. For X/Twitter, only posts submitted using Postpone are included in Analytics.
Next Steps
Explore the individual query documentation to learn more about specific analytics capabilities: