TikTok

POST

TikTok Content Posting API Privacy levels: SELF_ONLY | FOLLOWER_OF_CREATOR | MUTUAL_FOLLOW_FRIENDS | PUBLIC_TO_EVERYONE

Guide

Overview

TikTok Content Posting API

Privacy levels: SELF_ONLY | FOLLOWER_OF_CREATOR | MUTUAL_FOLLOW_FRIENDS | PUBLIC_TO_EVERYONE

Example Request Bodies

Default

{
  "title": "Check this out! #fyp",
  "video_url": "https://your-r2-or-cdn-url/video.mp4",
  "disable_duet": false,
  "privacy_level": "PUBLIC_TO_EVERYONE",
  "disable_stitch": false,
  "disable_comment": false,
  "scheduled_publish_time": null
}

Example Response

{
  "publish_id": "sdfger345-34-dfhgrt-3453sdgfg-34234"
}

Endpoint

Send your requests to the following URL using the specified HTTP method.

POST https://eranol.com/api/v1/social/tiktok/publish

Headers

Include the following headers with every request. Your API key is required for authentication.

Content-Type:application/json

x-api-key:YOUR_API_KEY

Request Body

Send the following JSON payload in the request body. Adjust the values to match your use case.

json

{
  "title": "Check this out! #fyp",
  "video_url": "https://your-r2-or-cdn-url/video.mp4",
  "disable_duet": false,
  "privacy_level": "PUBLIC_TO_EVERYONE",
  "disable_stitch": false,
  "disable_comment": false,
  "scheduled_publish_time": null
}

Example Request

Use the following cURL command to make a request to this API endpoint. Replace YOUR_API_KEY with your actual API key from the dashboard.

bash

curl -X POST "https://eranol.com/api/v1/social/tiktok/publish" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Check this out! #fyp","video_url":"https://your-r2-or-cdn-url/video.mp4","disable_duet":false,"privacy_level":"PUBLIC_TO_EVERYONE","disable_stitch":false,"disable_comment":false,"scheduled_publish_time":null}'

Example Response

Below is an example of a successful JSON response from this endpoint.

json

{
  "publish_id": "sdfger345-34-dfhgrt-3453sdgfg-34234"
}

Response Status

A successful request will return one of the following HTTP status codes.

200 OKRequest was successful and data is returned in the response body.

201 CreatedResource was successfully created.

401 UnauthorizedMissing or invalid API key.

429 Too Many RequestsRate limit exceeded. Try again later.

{ "title": "Check this out! #fyp", "video_url": "https://your-r2-or-cdn-url/video.mp4", "disable_duet": false, "privacy_level": "PUBLIC_TO_EVERYONE", "disable_stitch": false, "disable_comment": false, "scheduled_publish_time": null }

curl -X POST "https://eranol.com/api/v1/social/tiktok/publish" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"title":"Check this out! #fyp","video_url":"https://your-r2-or-cdn-url/video.mp4","disable_duet":false,"privacy_level":"PUBLIC_TO_EVERYONE","disable_stitch":false,"disable_comment":false,"scheduled_publish_time":null}'