ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Настройки публикации TikTok через API: приватность, комментарии, Duet и Stitch

API для бизнеса TikTok принимает настройки публикации в вызове publish, в основном внутри post_info. Для видео поддерживаются disable_comment, disable_duet и disable_stitch, обложка через thumbnail_offset или custom_thumbnail_url, маркировки is_brand_organic, is_branded_content и is_ai_generated. У фотопостов есть privacy_level, disable_comment, те же маркировки бренда и auto_add_music. GET /business/video/settings/ возвращает значения, которые разрешены для каждого аккаунта.

easyCoexistence публикует видео и фотопосты TikTok через publish_tiktok_post из Claude, ChatGPT или вашего кода, с подписью, заголовком фотопоста и включёнными или выключенными комментариями, а get_social_credentials даёт вашему коду токен, чтобы читать разрешённые настройки аккаунта.

3 levels

Варианты приватности фотопостов публичного аккаунта: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY.

FOLLOWER_OF_CREATOR

Уровень приватности, который получает закрытый аккаунт вместо PUBLIC_TO_EVERYONE: видно только его подписчикам.

false

По умолчанию disable_comment, disable_duet и disable_stitch равны false, поэтому комментарии, Duet и Stitch остаются включёнными, пока не заданы иначе.

1080 x 1920

Пользовательское изображение обложки видео должно быть не менее 360 x 360 пикселей и не больше 20 МБ.

Paid partnership

Маркировка is_branded_content применяется и имеет приоритет, если is_brand_organic тоже равно true.

privacy_level

Обязательное поле post_info фотопоста, ограниченное вариантами, которые возвращает GET /business/video/settings/ для аккаунта.

Какие настройки принимает каждый эндпоинт публикации?

/business/video/publish/ и /business/photo/publish/ имеют общие настройки и отличаются в других. Большинство находится внутри post_info, а custom_thumbnail_url и photo_cover_index располагаются на верхнем уровне тела запроса. Ниже они показаны рядом, как их перечисляет справочник TikTok. Там, где эндпоинт ничего не описывает для настройки, стоит «Нет поля»:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Что разрешено аккаунту?

GET /business/video/settings/ с business_id возвращает ограничения аккаунта на его публикации. Прочитайте его перед публикацией, поскольку TikTok принимает только перечисленные в нём значения:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY для публичного аккаунта; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY для закрытого.
  • comment_disabled: true, когда аккаунт не принимает комментарии ни от кого, и тогда disable_comment принимает только true.
  • duet_disabled и stitch_disabled: true, когда аккаунт разрешает Duet или Stitch только в режиме «Только вы» либо является закрытым; соответствующий переключатель тогда принимает только true.
  • max_video_post_duration_sec: самое длинное видео, которое аккаунт может опубликовать; более длинное завершится ошибкой.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

Кто может видеть публикацию?

У фотопоста это privacy_level, который вы отправляете: PUBLIC_TO_EVERYONE для людей в TikTok и вне его, MUTUAL_FOLLOW_FRIENDS для подписчиков, на которых аккаунт подписан в ответ, FOLLOWER_OF_CREATOR для подписчиков закрытого аккаунта, или SELF_ONLY. У эндпоинта видео поля приватности нет, так как он публикует публичные видео. Пост с настройкой «Друзья» или «Только вы» также нельзя посмотреть по его embed_url.

Как работают комментарии, Duet и Stitch?

Каждый из них является переключателем, который при значении true выключает функцию. disable_comment есть у обоих эндпоинтов; disable_duet и disable_stitch есть только у видео. По умолчанию все они равны false, что оставляет функцию включённой в рамках собственных настроек приватности аккаунта. Аккаунт, который не принимает комментарии ни от кого, или ограничивает Duet или Stitch режимом «Только вы», может публиковать только с переключателем, установленным в true.

Как выбирается обложка?

Для видео есть два способа. post_info.thumbnail_offset выбирает кадр по времени в миллисекундах, по умолчанию 0, с округлением до ближайшего кадра; время за концом видео отправляет вебхук об ошибке, и видео не публикуется. custom_thumbnail_url на верхнем уровне тела запроса задаёт изображение, и тогда TikTok игнорирует смещение. У фотопоста photo_cover_index выбирает одно из изображений, отсчёт ведётся с 0.

  • Пользовательская обложка: JPG, JPEG, WebP или PNG, до 20 МБ.
  • Размер: от 360 x 360 пикселей до 1080 x 1920 или 1920 x 1080.
  • Расположение: домен или префикс URL, подтверждённый для приложения, как и само видео.

Что означают маркировки бренда?

Пометки, которые TikTok показывает на публикации. is_brand_organic со значением true помечает её как «Рекламный контент» для публикаций, которые продвигают собственный бизнес аккаунта. is_branded_content со значением true помечает её как «Платное партнёрство» для публикаций, сделанных в платном партнёрстве с брендом, и имеет приоритет, если оба равны true. У видео с is_branded_content параметр tto_invite_link может привязать публикацию к кампании TikTok One Creator Marketplace, к которой присоединился аккаунт.

Какие другие параметры есть в post_info?

Ещё несколько, каждый описан в эндпоинте, который его принимает:

  • is_ai_generated, для видео: помечает публикацию как созданную автором с пометкой ИИ-генерации; после публикации изменить нельзя.
  • location_id и location_name: метка места, найденная через GET /business/publish/location/.
  • music_sound_info: коммерческий звук по ID; для видео также его громкость от 0 до 100 и начало и конец в миллисекундах.
  • auto_add_music, для фотопостов: добавляет рекомендуемую музыку, которую позже можно изменить в приложении TikTok.
  • upload_to_draft или is_draft: отправляет публикацию с видео во входящие автора как черновик с разрешением video.upload.
  • is_ads_only, для видео: публикует пост, видимый только в рекламе, который не остаётся в профиле.

Какие настройки задаёт publish_tiktok_post?

Три берутся из вашего запроса: подпись, заголовок фотопоста и disable_comment. easyCoexistence отправляет is_brand_organic и is_branded_content как false, публикует фотопосты как PUBLIC_TO_EVERYONE с первым изображением в качестве обложки и не передаёт остальные настройки видео, поэтому применяются значения TikTok по умолчанию: disable_duet и disable_stitch равны false, thumbnail_offset равен 0, is_ai_generated равен false.

Как отправить остальные настройки?

Из вашего кода, с токеном и business_id аккаунта из get_social_credentials, по путям Business API под business/. GET к business/video/settings/ читает ограничения аккаунта. POST к business/video/publish/ или business/photo/publish/ может содержать полное описанное тело; оно уходит в TikTok как есть, включая URL медиа, поэтому они должны находиться на домене или префиксе URL, подтверждённом для приложения. publish_tiktok_post представляет собой вызов, который направляет вашу ссылку через подтверждённый медиамаршрут easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Распространённые ошибки

  • Ожидание, что privacy_level работает для видео. Эндпоинт видео публикует публичные посты, а в его справочнике нет поля приватности; privacy_level принимают фотопосты.
  • Включение комментариев для аккаунта, который их не принимает. Когда comment_disabled равно true, TikTok принимает disable_comment только как true.
  • Задание thumbnail_offset за концом видео. TikTok отправляет вебхук об ошибке, и видео не публикуется.
  • Отправка PUBLIC_TO_EVERYONE для закрытого аккаунта. Его privacy_level_options перечисляют FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений; первые 3 дня бесплатно.

Часто задаваемые вопросы

Можно ли опубликовать закрытое видео в TikTok через API?

Не через эндпоинт видео, который публикует публичные посты. Фотопосты принимают privacy_level, включая SELF_ONLY, а видео можно отправить во входящие автора как черновик через upload_to_draft.

Как выключить Duet и Stitch через API?

Задайте post_info.disable_duet и post_info.disable_stitch равными true в /business/video/publish/. Если аккаунт уже ограничивает их, TikTok принимает только true.

Можно ли добавить метку места через API TikTok?

Да. post_info принимает location_id с location_name для метки места, найденной через GET /business/publish/location/.

В чём разница между is_brand_organic и is_branded_content?

is_brand_organic добавляет метку «Рекламный контент» для собственного бизнеса аккаунта; is_branded_content добавляет метку «Платное партнёрство» и имеет приоритет, если оба равны true.

Читайте дальше

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на