The API reference moved here from eksis.io/developers.

TikTok

TikTok publishes video and photo. Every post needs media, so there are no text-only posts. Media accepted: images and video. Comments are not available: TikTok has not opened its comments API to third-party apps. Direct messages are not available. Post metrics are available. First comments are not supported. eksis publishes at most 10 posts per account per rolling 24 hours.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
VideovideoOne video.1Video
PhotophotoImages as a swipeable photo post, with an optional title.1 to 35Images

Media requirements

Video (video)

  • Video: up to 4 GB, 1 s to 10 min long, aspect ratio 0.09:1 to 11.4:1.

Photo (photo)

  • Images: JPEG, WebP, PNG, up to 20 MB, aspect ratio 0.09:1 to 11.4:1, at most 1920 px wide.

Text limits

FieldLimitUnitNote
settings.title90charactersPhoto posts.

Settings

Options for TikTok go in targets[].settings of create and update post requests.

eksis optionFieldTypeValuesRequiredApplies to
Who can view this post: Who can view the post. TikTok has no default, so it must be chosen, and it must be one of the account's current options.settings.privacyfrom Read TikTok account settingsYesAll types
Allow comments: Let viewers comment.settings.allowCommentbooleanfrom Read TikTok account settingsNoAll types
Allow duet: Let others duet the video.settings.allowDuetbooleanfrom Read TikTok account settingsNovideo
Allow stitch: Let others stitch the video.settings.allowStitchbooleanfrom Read TikTok account settingsNovideo
Content disclosure: The post promotes a brand, product, or service.settings.commercialContentbooleanNoAll types
Your brand: Promotes your own brand. Ignored unless commercialContent is true.settings.brandOrganicbooleanWhen commercialContent is true and brandedContent is falseAll types
Branded content: Paid partnership with a third party. Ignored unless commercialContent is true.settings.brandedContentbooleanWhen commercialContent is true and brandOrganic is falseAll types
AI-generated content: The content was generated with AI.settings.isAigcbooleanNoAll types
Cover frame: Video frame to use as the cover, in milliseconds.settings.coverTimestampMsNovideo
Title: Title shown above a photo post.settings.titlestringNophoto
Cover photo: Which photo is the cover, counted from 0.settings.photoCoverIndexintegerNophoto
Let TikTok pick a soundtrack: Let TikTok add a soundtrack to a photo post.settings.autoAddMusicbooleanNophoto

A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.

Example target
{
  "channelId": "CHANNEL_ID",
  "contentType": "video",
  "settings": {
    "privacy": "PUBLIC_TO_EVERYONE",
    "allowComment": true,
    "allowDuet": false,
    "allowStitch": false,
    "commercialContent": false,
    "isAigc": false
  }
}

Comments and messages

  • First comment: not supported. TikTok has no comments API, so eksis cannot leave the first comment for you. A firstComment sent to this platform is refused with 422 and the code first_comment.unsupported.
  • Comments: not available. TikTok has not opened its comments API to third-party apps.
  • Private reply to a comment: not supported.
  • Direct messages: not available. TikTok has not opened its messaging API to third-party apps.

Analytics

  • Post metrics: reach, impressions, likes, comments, shares, saves.
  • Audience: follower count is tracked.

Daily limit

eksis publishes up to 10 posts per TikTok channel a day. A post over the limit is postponed, not failed.

Good to know

  • privacy and the interaction settings must match what the creator allows right now. Read getTikTokCreatorInfo before posting.
  • An account connected with upload permission only sends posts to the TikTok inbox as drafts for the creator to finish.
  • PNG photos and photos larger than 1080p are converted to JPEG before upload.
  • TikTok confirms publishing a few minutes later, so a target can turn published or failed after the call returns.
  • A caption over the limit is cut. A photo post without a title uses the first line of the caption.

Webhook events

Events a TikTok channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page