OMomnisocials
Analytics

Get best posting times

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

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/analytics/best-times
  • Auth
    HTTP bearer

Query parameters

platformstring required
Example:instagram

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

timezonestring
Example:Europe/Amsterdam

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

{
  "platform": "instagram",
  "timezone": "Europe/Amsterdam",
  "sample_size": 48,
  "metric": "engagement",
  "window_days": 365,
  "audience_online_date": "2026-10-20",
  "grid": [
    {
      "hour": 15,
      "score": 100,
      "n": 6,
      "typical_engagement": 132
    }
  ],
  "recommendations": [
    {
      "day": "tuesday",
      "hour": 15,
      "time": "15:00",
      "score": 100
    }
  ]
}

Changes

No recorded changes to this operation across all 21 revisions of this API.