TikTok API integration

What can you do with the TikTok API?

What is supported on the TikTok side

Publishing a video — starting with creator_info

TikTok requires creator_info before every post, and the user must pick the privacy level from that list themselves — no default value.

import asyncio
from socialift import TikTok

async def main(token: str, privacy_level: str):
    async with TikTok.from_env() as tt:          # TIKTOK_CLIENT_KEY / TIKTOK_CLIENT_SECRET
        info = await tt.creator_info(token)
        # privacy_level: the value the user picked from info["privacy_level_options"]
        if privacy_level not in info["privacy_level_options"]:
            raise ValueError("privacy level not allowed for this creator")
        result = await tt.publish_video(token, video_url="https://cdn.example.com/reel.mp4",
                                        title="New collection", privacy_level=privacy_level, wait=True)
        print(result["publish_id"])
        # Domain not verified? Upload the file itself in chunks
        await tt.publish_video(token, video="reel.mp4", privacy_level=privacy_level)

asyncio.run(main("ACCESS_TOKEN", privacy_level="SELF_ONLY"))  # the value chosen in your post form

Profile, videos and comments

Profile and videos work with the Login Kit token; insights and comments go through the Business API and need Business API access granted by TikTok.

import asyncio
from socialift import TikTok

async def main(token: str, video_id: str, comment_id: str):
    async with TikTok.from_env() as tt:
        profile = await tt.me(token)
        page = await tt.videos(token, limit=20)
        everything = await tt.iter_videos(token, max_items=100)

        # Business API: business_id = the creator's open_id
        biz = profile.id
        stats = await tt.business_videos(token, business_id=biz, max_count=20)
        account = await tt.business_account(token, business_id=biz)
        comments = await tt.comments(video_id, token, business_id=biz)
        await tt.reply_comment(comment_id, token, "Thank you!", video_id=video_id, business_id=biz)

asyncio.run(main("ACCESS_TOKEN", "VIDEO_ID", "COMMENT_ID"))

What each capability requires

The TikTok API is made up of several products, each with its own conditions. Use this table to plan the integration up front.

These conditions are set by TikTok — no SDK can work around them.

Connecting TikTok in four steps

1. 1

   Create a TikTok app

   In TikTok for Developers create an app, add Login Kit and the products you need, and copy the client key and client secret.

2. 2

   Add the keys to Socialift

   Enter the client key and secret on the “Kalitlar” (Keys) page: they are stored encrypted and can be checked against TikTok in one click. After saving, the page shows the redirect URI and webhook URL.

3. 3

   Set the redirect URI and webhook

   Paste that redirect URI into Login Kit and the webhook URL into the TikTok console. If you publish from URLs, verify the media domain or URL prefix.

4. 4

   Connect an account and test

   On the “Ulanishlar” (Connections) page connect a TikTok account via OAuth, send your first request in the Playground and move the generated code into the SDK.

Before you ship to production

• ▸A refresh may return a different refresh token — always store the value from the latest response.
• ▸The access token lives 24 hours: account for refreshes in long-running background jobs.
• ▸Call creator_info before every post and let the user pick privacy_level only from the list it returns.
• ▸An app that has not passed the audit can only post with SELF_ONLY privacy, from private accounts, and for at most 5 users per 24 hours — that is TikTok's rule.
• ▸For URL-based publishing, verify the domain in advance or upload the file directly.
• ▸Don't rely on the HTTP status alone: Open API v2 responses carry a string error.code (ok on success) and a log_id that TikTok support asks for.