The Best Times to Post endpoint returns a heatmap of optimal posting times for a specific account, based on historical performance. Use it to power schedule suggestions, calendar overlays, and autofill routines.
Authentication: Bearer API token
Scope: analytics
Headers:
Authorization: Bearer-API YOUR_API_KEY
Publer-Workspace-Id: YOUR_WORKSPACE_ID
GET /api/v1/analytics/:account_id/best_timesRetrieves a day/hour heatmap of posting performance tailored to the audience of the specified account. Optionally include competitor data and restrict to a custom date range.
account_id
string
No
Social account to analyze. Omit for all workspace accounts.
competitors
string
No
For competitor data. true or false (default false).
competitor_id
string
No
Analyze a specific competitor (requires competitors=true).
from
date (YYYY-MM-DD)
Yes
Start date (inclusive).
to
date (YYYY-MM-DD)
Yes
End date (inclusive).
Object keyed by day of week (Monday..Sunday).
Each day maps to an array of 24 numbers (hour indexes 0..23).
Each number is a relative engagement/performance score (higher = better posting time). Use for ranking and heatmap intensity; not a percentage.
Default window: If no dates are provided, best times are computed from recent history (commonly last 7 days).
Workspace/account settings (e.g., “day starts at” and “week starts on”) influence the visualization in the app; the API always returns 24 hourly slots per day.
Heatmap scores are relative within the dataset; normalize in your UI if combining multiple accounts.
Competitor view requires competitors=true; use competitor_id to focus on a single competitor.
Data refreshes automatically (about every 24 hours). Use Sync Insights in the UI for on‑demand refresh.
Charts — Discover chart IDs and fetch chart data
Post Insights — Per‑post performance analytics
Hashtag Analysis — Hashtag performance
Members — Workspace member analytics
Retrieves the optimal posting times for a specific social media account based on historical analytics data. Returns a heatmap of posting performance across days of the week and hours of the day, tailored to the specified account's audience engagement patterns.
Social media account ID to analyze posting times for. When provided, analysis is specific to this account's performance data
Include competitor data in best times analysis. Set to 'true' to analyze competitor posting patterns
Specific competitor ID to analyze. Used in conjunction with competitors=true parameter
Start date for analytics data range (YYYY-MM-DD format). Filters data from this date onwards
{"value":"2024-01-01"}End date for analytics data range (YYYY-MM-DD format). Filters data up to this date
{"value":"2024-12-31"}ID of the workspace to retrieve best times from
Best times to post data organized by day of the week and hour for the specific account
Unauthorized
Permission denied - requires analytics access or paying subscription
GET /api/v1/analytics/{account_id}/best_times HTTP/1.1
Host: app.publer.com
Publer-Workspace-Id: text
Accept: */*
{
"Monday": [
0,
0,
0,
0,
0,
0,
5,
12,
18,
25,
22,
15,
8,
10,
16,
20,
18,
14,
12,
8,
5,
3,
1,
0
],
"Tuesday": [
0,
0,
0,
0,
0,
0,
6,
15,
20,
28,
25,
18,
10,
12,
18,
22,
20,
16,
14,
10,
6,
4,
2,
0
],
"Wednesday": [
0,
0,
0,
0,
0,
0,
7,
16,
22,
30,
27,
20,
12,
14,
20,
24,
22,
18,
16,
12,
8,
5,
3,
0
]
}