The Post Insights endpoint retrieves detailed performance analytics for published posts, with powerful filtering, sorting, and pagination. Use it to build per-post dashboards, leaderboards, and competitor comparisons.
Authentication: Bearer API token
Scope: analytics
Headers:
Authorization: Bearer-API YOUR_API_KEY
Publer-Workspace-Id: YOUR_WORKSPACE_ID
Retrieve comprehensive analytics for posts within a workspace or a specific social account. Supports competitor analysis, text search, labels, post types, date ranges, member filtering, and multiple sort options.
GET /api/v1/analytics/:account_id/post_insightsWhen :account_id is a specific social account ID, results are limited to that account.
When :account_id is omitted, results include all accessible accounts.
Enable competitor mode with competitors=true and optionally narrow to a single competitor via competitor_id , see Competitor Analysis how to fetch competitor ids.
account_id
string
No
Social account ID to scope results. When used with competitors: true, it will filter all competitor posts related to this account.
competitors
string
No
For competitor insights. true or false (default false).
competitor_id
string
No
Competitor account ID to analyze (requires competitors=true).
from
date (YYYY-MM-DD)
No
Start date (inclusive). Filters posts scheduled/published on or after this date.
to
date (YYYY-MM-DD)
No
End date (inclusive). Filters posts scheduled/published on or before this date.
query
string
No
Case-insensitive search across post text, title, link description, video title.
postType
string
No
Filter by post type. One of: poll, status, link, carousel, photo, gif, video, reel, document, short, article, story.
sort_by
string
No
Sort field. One of: scheduled_at, reach, engagement, engagement_rate, click_through_rate, reach_rate, postType, likes, video_views, comments, shares, saves, link_clicks, post_clicks. Default scheduled_at.
sort_type
string
No
Sort direction. ASC or DESC. Default DESC.
page
integer
No
Page number (0-based). Each page contains 10 posts. Default 0.
member_id
string
No
Filter by the workspace who created the post.
Data sources: Metrics come from the official social network APIs. Insights auto‑sync periodically; you can manually sync in the UI for fresher data.
Post vs aggregate reach: Post Insights show reach per post. Charts/overview may show total reach across all posts for a time window, so numbers won’t necessarily sum 1:1.
Engagement formula: Typically the sum of likes/reactions + comments + shares + saves + post clicks (platform‑dependent).
Engagement Rate (%) ≈ engagement / reach * 100
Click‑Through Rate (%) ≈ link_clicks / reach * 100
Reach Rate (%) ≈ reach / followers * 100 (where available)
Platform differences: Not all metrics are available for all networks or account types (e.g., LinkedIn Profiles vs Pages).
Pagination: Use page (0‑based). Each page returns 10 posts. Response includes total to compute more pages.
Competitors: Requires competitors=true. Use competitor_id to focus on a single competitor’s posts; otherwise data may include multiple competitors (if enabled).
Charts — Discover chart IDs and fetch chart data
Hashtag Analysis — Track hashtag performance
Best Times — Suggested posting time slots
Members — Member (team) analytics
Retrieves comprehensive analytics data for published posts with advanced filtering, sorting, and pagination capabilities.
Filter posts for a specific social media account ID. If omitted, includes all workspace accounts. Used with competitors parameter for competitor-specific analysis
Include competitor analysis data. Set to 'true' to retrieve competitor post insights
Specific competitor account ID to analyze when competitors=true. Works in conjunction with account_id parameter
Start date for post insights data range (YYYY-MM-DD format). Filters posts scheduled on or after this date
{"value":"2024-01-01"}End date for post insights data range (YYYY-MM-DD format). Filters posts scheduled on or before this date
{"value":"2024-12-31"}Search query to filter posts by text content, title, link description, or video title using case-insensitive matching
Filter posts by specific post type (e.g., image, video, link, text, carousel)
Field to sort results by. Supports various engagement and performance metrics
Sort order direction
Page number for pagination (0-based indexing). Each page contains 10 posts
Filter posts by specific workspace member/user ID who created or manages the posts
ID of the workspace to retrieve insights from
Post insights data with analytics metrics and pagination information
Unauthorized
Permission denied - requires analytics access or paying subscription
GET /api/v1/analytics/{account_id}/post_insights HTTP/1.1
Host: app.publer.com
Publer-Workspace-Id: text
Accept: */*
{
"posts": [
{
"id": "text",
"text": "text",
"title": "text",
"scheduled_at": "2025-08-21T00:04:34.589Z",
"post_type": "text",
"account_id": "text",
"details": {
"labels": [
{
"id": "text",
"name": "text",
"color": "text"
}
]
},
"analytics": {
"reach": 1,
"engagement": 1,
"engagement_rate": 1,
"likes": 1,
"comments": 1,
"shares": 1,
"saves": 1,
"video_views": 1,
"link_clicks": 1,
"post_clicks": 1,
"click_through_rate": 1,
"reach_rate": 1
}
}
],
"total": 1
}