Get optimal posting times
GET /api/social-analytics/optimal-times
GET
/api/social-analytics/optimal-times
Heatmap of best posting times per platform from historical engagement data.
Authorizations
Parameters
Query Parameters
start_date
required
Period start date (YYYY-MM-DD)
string format: date
Period start date (YYYY-MM-DD)
end_date
required
Period end date (YYYY-MM-DD)
string format: date
Period end date (YYYY-MM-DD)
Responses
200
Successful Response
Array<object>
Optimal posting time slot derived from historical engagement data.
Attributes: day_of_week: ISO weekday (0=Monday, 6=Sunday). hour: Hour of day (0-23, UTC). platform: Social platform identifier. avg_engagement: Average engagement for posts at this time. sample_size: Number of posts used to compute the average.
object
avg_engagement
number
day_of_week
required
integer
hour
required
integer
platform
required
string
sample_size
integer
422
Validation Error
object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string