REST API
Multiple Users
GUI Dashboard
Packages & Guides
TikTok
Options for posting via the API to TikTok
TikTok API Endpoint
Overview
TikTok does asynchronous processing of videos. They require that after uploading the video your user open their mobile TikTok app to finalize the processing.
Please see details on the TikTok process:
TikTok Video Post
JSON for a basic post with a video to TikTok:
1
{
2
"post": "The best TikTok video ever #best https://www.tiktok.com",
3
"mediaUrls": ["https://images.ayrshare.com/imgs/test-video-1.mp4"],
4
"platforms": ["tiktok"]
5
}
Copied!
Please note, the
post field is required, but not currently supported by TikTok. The user must manually enter in the description within the TikTok app.The response will have the
id field set to "pending". After the user completes the processing the mobile app, the id field will be updated with the TikTok video ID. The idShare is used for internal referencing the video is awaiting final processing.Example JSON post:
1
{
2
"status": "success",
3
"errors": [],
4
"postIds": [
5
{
6
"status": "success",
7
"idShare": "video.7088122496758679353.nzLqBWbf",
8
"id": "pending",
9
"platform": "tiktok"
10
}
11
],
12
"id": "lb42orDhySAZmLWtj6b6",
13
"refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1",
14
"post": "The best TikTok video ever #best https://www.tiktok.com"
15
}
Copied!
If an error occurs, such as TikTok was unable to process the video, the
id field will be set to "failed" and the errors field will contain the error details.Note 1: If your video doesn't end in a known video extension such as mp4, please use the
isVideo parameter. See the /post endpoint for details.Note 2: The status of the TikTok post can be retrieved with the history endpoint:
​
Last modified 1mo ago
Copy link