TikTok scheduling limits

Threads

No; parts join into one post. Check the joined text against the destination limit before scheduling.

A thread starts with the main post text. You add the later parts under it in the composer (agents send them as options.thread.parts). Check the final text for each destination: an override changes that account's text, while destinations without threads receive the parts joined together.

Images and video

The format controls the files you can attach. A video goes alone rather than alongside images or other videos. A PDF document also goes alone. Counts and sizes below are the composer's checks, rather than a promise about every file the network accepts. Aspect ratios mean width divided by height. Size and duration checks run when those measurements are known; unknown measurements are skipped.

Alt text

Image: not available
Video: not available

Alt text is set per uploaded media ID in options.alt. It is trimmed, repeated whitespace is collapsed and the saved text is capped before the destination checks. Support depends on the file kind and the posting partner, so attaching a description to a file does not mean that every destination receives it.

First comment

Validation: 1200 Unicode characters; delivery: up to 1200 UTF-16 code units (emoji and some symbols count as 2). Before validation, first_comment is trimmed and truncated to 2200 UTF-16 code units. The posting adapter also truncates at 1200 UTF-16 code units.

A first comment and a delayed follow-up are separate settings. A follow-up uses options.follow_up and the account's own capabilities; do not use the first-comment ceiling to size a delayed reply.

Inbox and post analytics

Read and reply to imported comments. Hide: available where the comment permits it. Like: available where the comment permits it.

Post analytics reads: views, likes, comments, shares. Needs our posting partner's analytics access and a post reference; data may be unavailable.

Missing analytics should be treated as unavailable data. It does not establish that a post has no views or engagement. The inbox imports comments on your posts; it is not a general feed of everything said on the network.

Before you schedule

• Choose who can see the post explicitly in options.targets.tiktok.privacy; agents must supply privacy.
• Photo mode takes up to 10 JPG or WebP images.
• Read posting settings for the account before asking for comments, Duet or Stitch.

Title: Not available. Special option keys from the composer: None in NET_OPTS.

Preview the post after changing files, text or destination options. The composer checks the final account text and the selected format. Fix errors before scheduling; warnings explain changes or limitations that need a closer look.

Other text and cover checks

The shared text field is truncated to 63206 UTF-16 code units before platform validation. An emoji can use more than one unit. Video cover choices: image, offset. Cover images: up to 20 MB.

Known gaps

• Image and video alt text are not available through the posting partner.
• A post with comments switched off takes no follow-up.
• Account posting settings can refuse a privacy or interaction choice.

Ask an agent to prepare a post

Start with an account connected by the owner and an agent sign-in with read and draft permissions. This prompt asks for a draft you can inspect:

Use get_workspace and list_accounts. For my TikTok account, call get_account_options. Help me draft a behind-the-scenes post. Ask me for any required media or account choices. Run preview_post, explain every problem, then use create_post with when: "draft". Return the review_url. Do not schedule it.

The REST example saves a draft. Replace media IDs with files you uploaded and account choices with values from your account's capabilities and lists. For Reddit, replace the subreddit placeholder. To check the same body without saving, send it to /api/v1/posts/preview.

curl -s -X POST https://posteveryplatform.com/api/v1/posts \
  -H "Authorization: Bearer $PEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "A look behind the scenes.",
  "platforms": [
    "tiktok"
  ],
  "when": "draft",
  "media_ids": [
    "med_replace_with_uploaded_file"
  ],
  "options": {
    "targets": {
      "tiktok": {
        "privacy": "self",
        "comments": true
      }
    }
  }
}'

Scheduling uses when: schedule with scheduled_at, or when: queue for the next posting slot. The schedule permission is required. Scheduled agent posts wait for approval by default; the response tells you whether it is waiting and gives a review_url. With no plan or trial the workspace is read-only and writing answers plan_required. Find setup steps for your agent.

Questions about TikTok