Posting to TikTok through the API

The one where volume and audio matter most. The request shape is the same one every network here uses — only the limits on this page change.

TikTok has approved our app, and connecting works. Posting on your behalf needs one more TikTok audit, which we are preparing to reapply for. The status page tracks it.

Connecting a TikTok account

Needs a TikTok developer app with Content Posting API. Once connected, we hold the credential and keep it alive; your code only ever sends the API key.

The limits we enforce before publishing

What pre-flight rejects, verbatim

A request that breaks a TikTok rule comes back as a 422 naming the network and the number — before anything is scheduled, not after the other networks published. The error strings are these:

• 2332 chars — TikTok allows 2200.
• 37 attachments — TikTok allows 35.
• TikTok requires media.
• Video is 20m — TikTok allows 10m.

The request

curl -X POST https://attentionpilot.com/api/v1/posts \
  -H "Authorization: Bearer $PILOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Written for TikTok, under 2200 characters.",
    "accounts": ["tiktok"]
  }'

Omit schedule for the next free queue slot, send "now" to publish immediately, or send an ISO timestamp.

When TikTok fails

Each network is delivered on its own. A revoked token or a rejected upload on TikTok never blocks your other targets: the post returns "partial", the TikTok target carries the error text, and you can retry just this delivery.

Worth knowing

• ✓2,200 characters
• ✓Carousels up to 35 images
• ✓Video 3s to 10m
• ✓Carousels publish with TikTok's trending-sound selection enabled

The same call reaches the rest