tebarDocs
GuideDevelopersAPI ReferenceChangelog
Insights

Best times to post on an account

GET
/v1/accounts/{id}/best-times

When the account's own posts of the last 90 days did best, in 2-hour blocks and by weekday of tz (Asia/Jakarta by default): each block's score is the median outlier multiplier of its posts (1.0 is the account's usual), null with fewer than 5 posts there. TikTok adds the followers' activity per block (audience_share). recommended: up to 3 blocks, best first. A correlation from the account's own posts, not a promise.

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Query Parameters

tz?string
Lengthlength <= 64

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

Blocks, weekdays and the recommended blocks.

Example Request
curl -X GET 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/best-times'
Example Response
Empty