> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tiktok

> TikTok short-form video platform + creation tools + social sharing

![Tiktok logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tiktok.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=75dda42738096e6fd774bae464b26b21)

* **Category:** social media accounts
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `TIKTOK`
* **Version:** 20261101\_00

## Tools

> [accordion] Fetch publish status
>
> **Slug:** `TIKTOK_FETCH_PUBLISH_STATUS`
>
> Check the processing status of a TikTok video or photo post using its publish\_id. Use this action to poll the status of content after initiating an upload or post. The API returns detailed information about processing stages (upload, download, moderation) and any errors that occurred. Non-terminal statuses mean processing is still pending — never re-initiate TIKTOK\_PUBLISH\_VIDEO for the same publish\_id. Use exponential backoff when polling (e.g., 5s→10s→20s) to avoid the 30 requests/minute per access token rate limit.
>
> #### Input Parameters
>
> **publish\_id** `string` *required*
>
> The unique identifier (max 64 characters) returned from a video upload or photo post initialization. Used to track the posting action and check its processing status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user stats
>
> **Slug:** `TIKTOK_GET_USER_STATS`
>
> Fetches TikTok user information and statistics for the authenticated user. Retrieves user stats (follower\_count, following\_count, likes\_count, video\_count) and can optionally fetch profile fields (display\_name, username, bio\_description, etc.) and basic info (open\_id, union\_id, avatar URLs). Returns only the fields requested in the fields parameter. Only works for the authenticated account; cannot fetch arbitrary public profiles. Stats may be delayed and not reflect the most recent activity.
>
> #### Input Parameters
>
> **fields** `array`
>
> List of fields to retrieve. Available fields: Stats fields (user.info.stats scope): follower\_count, following\_count, likes\_count, video\_count. Profile fields (user.info.profile scope): username, bio\_description, profile\_deep\_link, is\_verified. Basic fields (user.info.basic scope): open\_id, union\_id, avatar\_url, avatar\_url\_100, avatar\_large\_url, display\_name. Defaults to the 4 statistics fields. Requesting fields without the corresponding OAuth scope returns missing or incomplete data for those fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List videos
>
> **Slug:** `TIKTOK_LIST_VIDEOS`
>
> Lists the authenticated user's own **public** TikTok videos, newest first. Only public posts are returned — private/`SELF_ONLY`, friends-only, and draft videos never appear (this is a property of the underlying `video.list` scope, not a bug), so on an account with no public posts the list is empty. Cannot list an arbitrary creator's videos, and does not provide a global TikTok-wide feed. Returns a single page (up to `max_count`, capped at 20). It does NOT auto-loop: when `has_more` is true, call again passing the returned `cursor` to fetch the next page. Accounts with more than `max_count` public videos are otherwise silently truncated.
>
> #### Input Parameters
>
> **cursor** `integer`
>
> Pagination cursor (UTC Unix timestamp in milliseconds) returned from previous call's response. Stop pagination when no next cursor is returned.
>
> **max\_count** `integer`
>
> Maximum number of videos to retrieve per page. Default is 10, maximum is 20.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post photo
>
> **Slug:** `TIKTOK_POST_PHOTO`
>
> Create a photo post (1-35 images) on TikTok via Content Posting API. Supports two modes: - MEDIA\_UPLOAD: Uploads photos to user's inbox for review/editing before posting - DIRECT\_POST: Immediately posts photos to user's TikTok account IMPORTANT: Photo URLs must be from your TikTok-verified domain. Unverified domains will return 403 Forbidden. Unaudited apps can only post with privacy='SELF\_ONLY'. Rate limit: 6 requests per minute per user access token. Reference: [https://developers.tiktok.com/doc/content-posting-api-reference-photo-post](https://developers.tiktok.com/doc/content-posting-api-reference-photo-post)
>
> #### Input Parameters
>
> **title** `string`
>
> Post title (\<= 90 UTF-16 runes)
>
> **post\_mode** `string ("DIRECT_POST" | "MEDIA_UPLOAD")`
>
> Use DIRECT\_POST to publish immediately (requires video.publish), or MEDIA\_UPLOAD to send to inbox for editing (requires video.upload)
>
> **description** `string`
>
> Post description (\<= 4000 UTF-16 runes)
>
> **photo\_images** `array` *required*
>
> List of 1-35 publicly accessible HTTPS image URLs (JPG, JPEG, or WEBP format). IMPORTANT: URLs must be from your TikTok-verified domain or URL prefix. Random/third-party URLs will be rejected with 403 error.
>
> **privacy\_level** `string ("PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY")`
>
> Privacy levels accepted by TikTok's Content Posting API.  The valid set for a given account is only discoverable via `/v2/post/publish/creator_info/query/`. For unaudited apps only `SELF_ONLY` is permitted.  [https://developers.tiktok.com/doc/content-posting-api-reference-direct-post](https://developers.tiktok.com/doc/content-posting-api-reference-direct-post)
>
> **auto\_add\_music** `boolean`
>
> DIRECT\_POST only. Auto add recommended music.
>
> **disable\_comment** `boolean`
>
> DIRECT\_POST only. Disallow comments if true.
>
> **photo\_cover\_index** `integer` *required*
>
> Zero-based index (0 to len(photo\_images)-1) indicating which image to use as the cover/thumbnail
>
> **brand\_content\_toggle** `boolean`
>
> DIRECT\_POST only. Set true if content is a paid partnership to promote a third-party business.
>
> **brand\_organic\_toggle** `boolean`
>
> DIRECT\_POST only. Set true if content promotes the creator's own business.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish video
>
> **Slug:** `TIKTOK_PUBLISH_VIDEO`
>
> Publishes a video to TikTok by pulling it from a public URL. TikTok downloads the video from the provided URL and publishes it directly to the creator's profile. Publishing is asynchronous — after calling this action, poll TIKTOK\_FETCH\_PUBLISH\_STATUS with the returned publish\_id to check completion. For uploading video files instead of URLs, use TIKTOK\_UPLOAD\_VIDEO.
>
> #### Input Parameters
>
> **caption** `string`
>
> Optional caption/title text for the video post. Maximum length: 2200 UTF-16 characters.
>
> **is\_aigc** `boolean`
>
> Set true to label the video as AI-generated content.
>
> **video\_url** `string` *required*
>
> A publicly accessible URL of the video to publish. TikTok will pull the video from this URL. Must be HTTP/HTTPS. The video will be downloaded by TikTok's servers, so ensure the URL is accessible and not behind authentication.
>
> **disable\_duet** `boolean`
>
> Whether to disable duets on the video.
>
> **privacy\_level** `string ("PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY")` *required*
>
> Privacy level selected by the user for the published video. Must be one drawn from the account's creator\_info/query options. For unaudited apps only SELF\_ONLY is permitted.
>
> **disable\_stitch** `boolean`
>
> Whether to disable stitches on the video.
>
> **disable\_comment** `boolean`
>
> Whether to disable comments on the video.
>
> **brand\_content\_toggle** `boolean`
>
> Set true if the content is a paid partnership promoting a third-party business.
>
> **brand\_organic\_toggle** `boolean`
>
> Set true if the content promotes the creator's own business.
>
> **video\_cover\_timestamp\_ms** `integer`
>
> Timestamp in milliseconds to use as video cover/thumbnail.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query creator info
>
> **Slug:** `TIKTOK_QUERY_CREATOR_INFO`
>
> Queries the authenticated creator's info and current posting options. Returns the account's available `privacy_level_options` and interaction settings (comment/duet/stitch), which the Content Posting API requires you to read before a direct post — the valid `privacy_level` values for an account are only discoverable here. Call this to pick a real privacy level instead of guessing (unaudited apps only ever get SELF\_ONLY).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query videos
>
> **Slug:** `TIKTOK_QUERY_VIDEOS`
>
> Fetches metadata for specific TikTok videos by ID (1-20 per request). Verifies the videos belong to the authenticated user and returns their details, refreshing the cover-image URL's expiration. Unlike List videos, this looks up known video IDs rather than walking recent uploads.
>
> #### Input Parameters
>
> **video\_ids** `array` *required*
>
> List of TikTok video IDs to fetch metadata for (1-20 per request). Only videos that belong to the authenticated user are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload video
>
> **Slug:** `TIKTOK_UPLOAD_VIDEO`
>
> Uploads a video to TikTok's inbox or initiates a direct post using the Content Posting API. Direct posting requires a privacy level; the returned published flag reflects the requested mode, not confirmation that publishing completed.
>
> #### Input Parameters
>
> **caption** `string`
>
> Optional caption/title used when publish=true. Max 2200 UTF-16 runes.
>
> **is\_aigc** `boolean`
>
> Set true to label the video as AI-generated content.
>
> **publish** `boolean`
>
> If true, attempts to publish after upload using the returned publish\_id.
>
> **disable\_duet** `boolean`
>
> Whether to disable duets on the video.
>
> **privacy\_level** `string ("PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY")`
>
> Privacy levels accepted by TikTok's Content Posting API.  The valid set for a given account is only discoverable via `/v2/post/publish/creator_info/query/`. For unaudited apps only `SELF_ONLY` is permitted.  [https://developers.tiktok.com/doc/content-posting-api-reference-direct-post](https://developers.tiktok.com/doc/content-posting-api-reference-direct-post)
>
> **disable\_stitch** `boolean`
>
> Whether to disable stitches on the video.
>
> **file\_to\_upload** `object` *required*
>
> Video file to upload to TikTok. Files are uploaded whole when possible and split into sequential TikTok-compatible chunks for larger videos. Supported formats include MP4, MOV, WEBM. Recommended aspect ratio 9:16.
>
> **disable\_comment** `boolean`
>
> Whether to disable comments on the video.
>
> **chunk\_size\_bytes** `integer`
>
> Optional chunk size for multipart uploads. Must be between 5,000,000 and 64,000,000 bytes and must produce a valid TikTok upload plan. Omit this to choose a safe chunk size automatically.
>
> **brand\_content\_toggle** `boolean`
>
> Set true if the content is a paid partnership promoting a third-party business.
>
> **brand\_organic\_toggle** `boolean`
>
> Set true if the content promotes the creator's own business.
>
> **video\_cover\_timestamp\_ms** `integer`
>
> Timestamp in milliseconds to use as video cover/thumbnail (e.g., 1000 for 1 second into video).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload videos (batch)
>
> **Slug:** `TIKTOK_UPLOAD_VIDEOS`
>
> Uploads multiple videos to TikTok concurrently, either to the creator's inbox as drafts or using the direct publishing flow. Returns per-file upload results; direct publication status can be checked using the returned publish IDs.
>
> #### Input Parameters
>
> **caption** `string`
>
> Optional caption/title used when publish=true. Max 2200 UTF-16 runes.
>
> **is\_aigc** `boolean`
>
> Set true to label the videos as AI-generated content.
>
> **publish** `boolean`
>
> If true, attempts to publish after each upload using direct publish flow.
>
> **max\_workers** `integer`
>
> Maximum number of parallel uploads
>
> **disable\_duet** `boolean`
>
> Whether to disable duets on the videos.
>
> **privacy\_level** `string ("PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY")`
>
> Privacy levels accepted by TikTok's Content Posting API.  The valid set for a given account is only discoverable via `/v2/post/publish/creator_info/query/`. For unaudited apps only `SELF_ONLY` is permitted.  [https://developers.tiktok.com/doc/content-posting-api-reference-direct-post](https://developers.tiktok.com/doc/content-posting-api-reference-direct-post)
>
> **disable\_stitch** `boolean`
>
> Whether to disable stitches on the videos.
>
> **disable\_comment** `boolean`
>
> Whether to disable comments on the videos.
>
> **files\_to\_upload** `array` *required*
>
> List of video files to upload to TikTok in parallel (at least one). Files are uploaded whole when possible and split into sequential TikTok-compatible chunks for larger videos. Supports common video formats like MP4, MOV, WebM. Too-long or unsupported-codec files are rejected. Caption (via `caption`) must also be within TikTok's length limit.
>
> **chunk\_size\_bytes** `integer`
>
> Optional chunk size for multipart uploads. Must be between 5,000,000 and 64,000,000 bytes and must produce a valid TikTok upload plan for every file. Omit this to choose a safe chunk size automatically.
>
> **brand\_content\_toggle** `boolean`
>
> Set true if the content is a paid partnership promoting a third-party business.
>
> **brand\_organic\_toggle** `boolean`
>
> Set true if the content promotes the creator's own business.
>
> **video\_cover\_timestamp\_ms** `integer`
>
> Timestamp in milliseconds to use as video cover/thumbnail.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
