Skip to content
Dashboard

Best times to post on an Instagram account

GET
/instagram/insights/best-times
curl --request GET \
--url 'https://app.whatsetter.com/api/v1/instagram/insights/best-times?tz=Europe%2FParis' \
--header 'Authorization: Bearer <token>'

On which days and at what hours the account’s posts of the last 90 days do better than the average of their kind (each post against its kind, a viral post counted as 3× at most), and the next three moments to post (next_slots, one per day, in the next 7 days, at least 30 minutes ahead). With too few posts (basis: usual, reason: few), nothing above the average (flat) or no insights permission (none), next_slots are usual hours (12:30, 19:00). Requires scope instagram:read.

account_id
string

Required when the workspace has several Instagram accounts.

tz
string
Example
Europe/Paris

IANA time zone the days and hours are read in (default the account’s agent’s).

The best times

Media typeapplication/json
object
data
object
account
object
id
string
username
string
nullable
tz
string
basis
string
Allowed values: account usual
reason
string
nullable
Allowed values: few flat none
posts_read
integer
posts_needed
integer
best_day
object
weekday
string
Allowed values: monday tuesday wednesday thursday friday saturday sunday
vs_average
number
best_hours
object
from_hour
integer
to_hour
integer
vs_average
number
by_weekday
Array<object>
object
weekday
string
posts
integer
vs_average
number
nullable
by_hours
Array<object>
object
from_hour
integer
to_hour
integer
posts
integer
vs_average
number
nullable
next_slots
Array<object>
object
at
string format: date-time
local

The wall time in tz, YYYY-MM-DDTHH:mm.

string
score

The day’s and the hours’ advantage multiplied; null for a usual hour.

number
nullable
Example
{
"data": {
"basis": "account",
"reason": "few",
"best_day": {
"weekday": "monday"
}
}
}

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Resource not found in this workspace

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Invalid parameter or body (also an invalid or expired cursor)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Instagram limits the reads for this account right now (instagram_rate_limited).

Instagram does not answer right now (instagram_unavailable).