Интеграция TikTok API

Что можно делать через TikTok API

Что поддерживается на стороне TikTok

Публикация видео — начиная с creator_info

По правилам TikTok перед каждой публикацией запрашивается creator_info, а уровень приватности пользователь выбирает из этого списка сам — без значения по умолчанию.

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 — значение, которое пользователь сам выбрал из info["privacy_level_options"]
        if privacy_level not in info["privacy_level_options"]:
            raise ValueError("уровень приватности недоступен для этого автора")
        result = await tt.publish_video(token, video_url="https://cdn.example.com/reel.mp4",
                                        title="Новая коллекция", privacy_level=privacy_level, wait=True)
        print(result["publish_id"])
        # Домен не подтверждён — загрузите сам файл частями
        await tt.publish_video(token, video="reel.mp4", privacy_level=privacy_level)

asyncio.run(main("ACCESS_TOKEN", privacy_level="SELF_ONLY"))  # значение из формы публикации

Профиль, видео и комментарии

Профиль и видео доступны по токену Login Kit; статистика и комментарии работают через Business API и требуют доступа к Business API, выданного 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 — 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, "Спасибо!", video_id=video_id, business_id=biz)

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

Что требуется для каждой возможности

TikTok API состоит из нескольких продуктов, и у каждого свои условия. Таблица помогает спланировать интеграцию заранее.

Эти условия устанавливает TikTok — ни один SDK не может их обойти.

Подключение TikTok — четыре шага

1. 1

   Создайте приложение TikTok

   В TikTok for Developers создайте приложение, добавьте Login Kit и нужные продукты, получите client key и client secret.

2. 2

   Добавьте ключи в Socialift

   Введите client key и secret на странице «Kalitlar» (ключи): они хранятся в зашифрованном виде и проверяются на стороне TikTok в один клик. После сохранения там появятся redirect URI и адрес вебхука.

3. 3

   Настройте redirect URI и вебхук

   Вставьте этот redirect URI в Login Kit, а адрес вебхука — в кабинет TikTok. Если публикуете по ссылке, подтвердите домен или URL-префикс с медиа.

4. 4

   Подключите аккаунт и проверьте

   На странице «Ulanishlar» (подключения) подключите аккаунт TikTok через OAuth, отправьте первый запрос в Playground и перенесите готовый код в SDK.

Перед выходом в прод

• ▸При обновлении может вернуться другой refresh token — всегда сохраняйте значение из последнего ответа.
• ▸Access token живёт 24 часа: учитывайте обновление в долгих фоновых задачах.
• ▸Перед каждой публикацией вызывайте creator_info, а privacy_level пусть пользователь выбирает только из полученного списка.
• ▸Приложение без аудита может публиковать только с приватностью SELF_ONLY, с закрытого аккаунта и не более чем для 5 пользователей за 24 часа — это правило TikTok.
• ▸Для публикации по ссылке заранее подтвердите домен или загружайте файл напрямую.
• ▸Не полагайтесь только на HTTP-статус: в ответе Open API v2 есть строковый error.code (ok при успехе) и log_id, который запрашивает поддержка TikTok.