what does the best time to post api return
it returns timing buckets per platform and account timezone. you can request account-specific timing when the account has historical data or request the public baseline for new accounts.
feature for automation developers
best time to post api for account-specific timing and baseline data
fetch account-specific or public baseline timing data before scheduling. use the optimal-time analytics endpoint to plan drafts, queue approvals, and publish at each account best time to Instagram, TikTok, and X.
- Human decision before publishing
- Evidence and exceptions stay attached
- No generated testimonial or outcome claim
what it does
use the best time to post api to get timing choices before scheduling
fetching timing data first reduces failed posts and misaligned schedules. call the optimal-time analytics endpoint to receive per-account or public baseline timing buckets so your automation can pick a candidate publish slot before creating a draft.
this endpoint is part of TimeToPost. drafts created through the API land in one human approval queue. after a user approves a draft, the platform publishes at each account best time to Instagram, TikTok, or X. you must have posting permission for each connected account.
- account-specific timing when you have historical data
- public baseline timing when the account is new
- single approval queue for all drafts until a human approves
- publishes live to Instagram, TikTok, and X after approval
core requests
what to call and what to expect
the optimal-time analytics endpoint returns recommended timing buckets per platform and account timezone. use the account-specific mode for personalized schedules or the public baseline mode to seed new accounts.
the API flow pairs timing recommendations with draft creation and approval. after you submit a draft it appears in the single approval queue. only approved drafts are scheduled to publish at the chosen best time.
- optimal-time analytics endpoint. returns timing buckets per platform and timezone.
- public baseline endpoint. returns generalized timing for new accounts.
- draft creation request. creates content that waits in one approval queue.
- approval status query. check whether a draft is approved and scheduled.
integration steps
quick integration steps for automation developers
authenticate the developer account and ensure each social profile is connected with posting permission. request account-specific timing if the account has history, otherwise fetch the public baseline.
create the draft with the candidate time, and monitor the single approval queue. after a human approves the draft, TimeToPost schedules publishing at the account best time. verify posting by checking the approval and publish status.
- authenticate and confirm posting permission for each account
- fetch account-specific timing or public baseline
- select a candidate publish slot and attach it to the draft
- submit draft, monitor the single approval queue, obtain human approval
- after approval, verify that the platform scheduled the post for the recommended best time
production limits and approvals
permission, approval, and plan limits to plan for
the best time to post api is included with TimeToPost under the platform single low plan. plan limits apply to the number of connected accounts and posting frequency per account. consult your plan page or support for exact quotas before rolling into production.
the platform requires posting permission for each social account. all drafts created by any integration wait in the single human approval queue. do not assume automated publish without that approval step. live posting supports Instagram, TikTok, and X only.
- included in the platform single low plan. contact support for account-specific quotas
- posting permission required for each connected social account
- all drafts wait in one human approval queue until approved
- live publishing supported for Instagram, TikTok, and X
recommended use cases
when to call the best time to post api
call the endpoint when your workflow needs a candidate publish slot before creating a draft. this is useful for batch scheduling, onboarding new accounts using public baselines, and building approval workflows where a human reviews the content before publish.
avoid calling the endpoint for single ad hoc posts where a user picks time manually. use account-specific timing when you can, and fall back to the public baseline for accounts without history.
- batch scheduling and automation pipelines
- onboarding new accounts with public baseline data
- preparing drafts that require human approval
- adjusting candidate times by platform and account timezone
Questions for this workflow
Frequently asked questions
do drafts created by the api publish automatically
no. drafts created by the API appear in the single human approval queue. a human must approve the draft before the platform schedules it to publish at the account best time.
which platforms does this support
live publishing after approval supports Instagram, TikTok, and X. timing recommendations include platform context so you can choose platform-appropriate slots.
is this included in my plan and are there rate limits
the endpoint is included in TimeToPost under the single low plan. plan limits apply to connected accounts and posting frequency. check your plan page or contact support for specific quotas and any request limits.
Turn this plan into an approval-ready queue
Start with the workflow above, keep the human review gate, and adapt the cadence to the accounts you actually operate.
Start a review-first workflow