Social Analytics Insights

Overview#

Returns the three computed insights from your posting history: the best time slots to post (by day of week and hour, UTC), how posting frequency relates to engagement per platform, and how fast posts stop earning engagement after publishing.

These power the "Best time to post" heatmap on the Analytics page. All three are computed from your accounts' actual engagement, not generic benchmarks.

https://api.orshot.com/v1/social/analytics/insights

Request#

await fetch("https://api.orshot.com/v1/social/analytics/insights", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

day_of_week is Monday-first: 0 is Monday, 6 is Sunday. An insight the provider cannot compute yet (for example, too little posting history) comes back as an empty array rather than an error.

Query Parameters#

Error Responses#

Same as the analytics overview endpoint: 403 with code analytics_not_enabled, and 429 with a Retry-After header when the 10 requests per minute analytics budget is exhausted. An account_id that does not belong to the workspace returns 404.