TikTok Content Posting API: публикация видео и фото

Direct Post или Upload: что выбрать?

Сравнение Direct Post и Upload

Как опубликовать видео через Direct Post

Порядок важен: правила TikTok требуют запросить creator info и показать определённый интерфейс ещё до init-запроса.

1. 1

   Получите разрешение video.publish

   Автор должен авторизовать ваше приложение со scope video.publish через Login Kit. Access token живёт 24 часа — вовремя его обновляйте.

2. 2

   Запросите creator info

   POST /v2/post/publish/creator_info/query/ возвращает никнейм и аватар автора, privacy_level_options, comment_disabled, duet_disabled, stitch_disabled и max_video_post_duration_sec. Ошибки spam_risk_too_many_posts или reached_active_user_cap означают, что сейчас публикацию предлагать не стоит.

3. 3

   Покажите экран публикации по правилам

   Никнейм автора, выпадающий список приватности без значения по умолчанию, выключенные по умолчанию переключатели взаимодействий (неактивные, если автор их отключил), переключатель раскрытия коммерческого контента, превью и согласие с Music Usage Confirmation. Предупредите, что обработка может занять несколько минут.

4. 4

   Инициализируйте публикацию

   Отправьте post_info (title, privacy_level, disable_comment, disable_duet, disable_stitch, флаги брендированного контента) и source_info с источником FILE_UPLOAD или PULL_FROM_URL. В ответе будет publish_id, а для загрузки файла — upload_url.

5. 5

   Передайте медиа

   Для FILE_UPLOAD отправьте части методом PUT на upload_url в течение часа. Для PULL_FROM_URL TikTok сам скачивает файл с подтверждённого адреса.

6. 6

   Отследите результат

   Запрашивайте /v2/post/publish/status/fetch/ с publish_id или подпишитесь на вебхуки Content Posting и покажите пользователю итог.

Значения privacy_level

Отправляйте только значение, которое creator info вернул для этого автора, — иначе запрос отклонится с privacy_level_option_mismatch.

Список зависит от настроек аккаунта автора, поэтому не зашивайте его в код.

Direct Post на Python

SDK отправляет init-запрос, загружает части файла и при wait=True опрашивает статус, пока пост не опубликуется или не упадёт с ошибкой.

from socialift import TikTok

async def post_video(token: str, privacy: str, caption: str) -> dict:
    async with TikTok.from_env() as tt:
        info = await tt.creator_info(token)
        if privacy not in info["privacy_level_options"]:
            raise ValueError(f"{privacy} is not allowed for this creator")

        return await tt.publish_video(
            token,
            video="renders/launch.mp4",      # FILE_UPLOAD, SDK режет файл на части
            title=caption,
            privacy_level=privacy,           # до аудита только SELF_ONLY
            disable_comment=info.get("comment_disabled", False),
            disable_duet=info.get("duet_disabled", False),
            disable_stitch=info.get("stitch_disabled", False),
            wait=True,
        )

Что может и чего не может приложение без аудита

PULL_FROM_URL или FILE_UPLOAD

Оба источника работают для видео в Direct Post и Upload. Фотопосты поддерживают только PULL_FROM_URL.

Требования к медиа

Фотопосты, черновики и проверка статуса

Фото всегда берутся с подтверждённых URL. Загрузка во «Входящие» заканчивается статусом SEND_TO_USER_INBOX, поэтому проверяйте её через publish_status, а не ждите публикации.

from socialift import TikTok

async def carousel_and_draft(token: str) -> None:
    async with TikTok.from_env() as tt:
        # перед Direct Post — creator_info(), как в примере с видео
        carousel = await tt.publish_photos(
            token,
            photo_urls=[
                "https://media.example.com/tiktok/look-1.jpg",
                "https://media.example.com/tiktok/look-2.jpg",
            ],
            title="Осенний лукбук",
            description="Два образа из новой коллекции",
            privacy_level="SELF_ONLY",
            cover_index=0,
            wait=True,
        )
        print(carousel["status"]["status"])   # PUBLISH_COMPLETE

        draft = await tt.upload_video(token, video="renders/raw-cut.mp4")
        state = await tt.publish_status(draft["publish_id"], token)
        print(state["status"])                # PROCESSING_UPLOAD или SEND_TO_USER_INBOX

Статусы публикации

publicaly_available_post_id (в API написано именно так) возвращается только после того, как пост стал публичным и прошёл проверку; у приватных постов публичного ID нет.

Чек-лист публикации в TikTok для продакшена

• ▸Запрашивайте creator info перед каждым Direct Post и стройте список приватности из privacy_level_options.
• ▸Не задавайте значения по умолчанию для приватности и взаимодействий; отключённое автором делайте неактивным.
• ▸Держитесь в пределах 6 init-запросов и 30 запросов статуса в минуту на один user token.
• ▸Обрабатывайте spam_risk_too_many_posts и spam_risk_too_many_pending_share как паузу, а не как цикл повторов.
• ▸Не накладывайте на контент для TikTok логотипы, водяные знаки, ссылки или рекламный текст.
• ▸Храните медиа на подтверждённом HTTPS-префиксе без редиректов.
• ▸Пишите в лог log_id из каждого ответа с ошибкой — его запрашивает поддержка TikTok.