Sign in
Analytics

Get recommended posting times for a platform

Recommended day/hour posting slots for one platform, computed from the workspace's own posting history (publish time × engagement of every post published on that platform, recency-weighted, outlier-damped). Times are bucketed in the requesting user's timezone (overridable via timezone). When the workspace has fewer than 15 analyzed posts on the platform, a static industry-average table is returned instead — basis flips from own_data to defaults and posts_needed says how many more published posts unlock personalized recommendations. Grid scores are relative within the platform (100 = the best slot). Requires the analytics:read scope.

get/analytics/best-times

Query parameters

platformstring required

Platform identifier (e.g. instagram, tiktok, linkedin, linkedin_page, x).

timezonestring

IANA timezone for the buckets (e.g. Europe/Amsterdam). Defaults to the account's timezone, then UTC.

Response

Best-time grid and top recommendations

platformstring
timezonestring

IANA timezone the day/hour buckets are expressed in

basis'own_data' | 'own_data_and_audience' | 'audience' | 'defaults'

own_data = computed from this workspace's posts; own_data_and_audience = own posts blended with when the audience is online (Instagram, TikTok Business); audience = not enough posts yet, based on the audience-online profile only; defaults = industry averages (not enough history yet)

sample_sizeinteger

Number of analyzed posts (published >72h ago, last 365 days)

posts_neededinteger

How many more published posts unlock personalized recommendations (0 when basis is own_data)

metricstring

Always engagement in v1 (shared cross-platform engagement formula)

window_daysinteger
audience_onlineobject

Hour (0-23, in the response timezone) -> number of followers online, from the platform's audience-activity data. Present for Instagram and TikTok Business accounts with 100+ followers once the daily account snapshot has collected it.

audience_online_datestring date

Snapshot date of audience_online.

Example response

{
  "recommendations": [
    {
      "time": "15:00"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.