TikTok APIthrough Siar.

At a glance

Account needed: Any TikTok account. Creator details and privacy options are read from TikTok before every post.

Media rules

What Siar can do on TikTok

Siar can create comments and replies up to 150 characters, and import the comments people leave on your posts.

Publish a post

Put TikTok's payload under data.TIKTOK and list TIKTOK in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "TikTok post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "TIKTOK"
    ],
    "data": {
      "TIKTOK": {
        "type": "VIDEO",
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ]
      }
    }
  }'

TikTok fields

• type string default "VIDEO"
  One of: VIDEO IMAGE
• text string nullable
• uploadIds string[] nullable
• thumbnail string nullable
• privacy string nullable
  One of: SELF_ONLY PUBLIC_TO_EVERYONE MUTUAL_FOLLOW_FRIENDS FOLLOWER_OF_CREATOR
• photoCoverIndex integer nullable default 0 ≥ 0
• isBrandContent boolean nullable default false
• isOrganicBrandContent boolean nullable default false
• disableComments boolean nullable default false
• disableDuet boolean nullable default false
• disableStitch boolean nullable default false
• thumbnailOffset number nullable default 0
• isAiGenerated boolean nullable default false
• autoAddMusic boolean nullable default false
• autoScale boolean nullable default false
• uploadToDraft boolean nullable default false
• musicSoundInfo object nullable
  5 fields

  • musicSoundId string required min length 1
  • musicSoundVolume integer nullable ≥ 0≤ 100
  • musicSoundStart integer nullable ≥ 0
  • musicSoundEnd integer nullable ≥ 0
  • videoOriginalSoundVolume integer nullable ≥ 0≤ 100

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a TikTok account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• user.info.basic
• user.info.profile
• user.info.stats
• video.list
• video.publish
• video.upload
• user.info.username
• user.account.type
• user.insights
• video.insights
• comment.list
• comment.list.manage

TikTok-specific operations

These exist for TikTok only and live under /misc/tiktok.

When TikTok says no

Siar relays TikTok's error code and message verbatim on the post, next to a status you can act on. The TikTok error reference covers 15 common cases with what each one means and the fix. Open the TikTok error reference.