Как добавить публикацию в TikTok в ваш SaaS
Чтобы добавить публикацию в TikTok, SaaS подключает TikTok аккаунт каждого клиента по размещённой ссылке, затем вызывает POST /channels/{id}/posts в easyCoexistence с одним видео или 1–35 изображениями и подписью, сразу или с датой publish_at до 90 дней вперёд. Пост уходит через API for Business от TikTok, который разрешает 15 постов в день на аккаунт, а ваш бэкенд узнаёт, когда пост опубликован.
Видеопосты, которые TikTok публикует на аккаунт через API for Business, не более шести в минуту.
Наибольшее видео, которое принимает эндпоинт публикации TikTok: MP4, MOV или WebM, длиной от 3 до 600 секунд.
Наибольшее число изображений в одном фотопосте TikTok; каждое JPG, JPEG или WebP, до 20 МБ.
Единицы кода UTF-16, которые может содержать заголовок фотопоста TikTok.
На сколько вперёд эндпоинт постов easyCoexistence может запланировать пост в TikTok.
Как клиент подключает TikTok?
Через сессию подключения с параметром channel, равным tiktok. Размещённая страница показывает ваше название и кнопку «Continue with TikTok», которая открывает собственный экран согласия TikTok в той же вкладке. Клиент входит, разрешает доступ и попадает на ваш redirect_url с channel_id. Сохраните его рядом с клиентом, поскольку каждый запрос на публикацию называет канал.
Как выглядит запрос на публикацию в TikTok?
Один POST к /channels/{id}/posts с подписью в text и файлом в media. Не указывайте publish_at, чтобы опубликовать сразу, или задайте время в формате ISO 8601 со смещением, чтобы опубликовать позже. Пост «сейчас» возвращает 201 или 422 с причиной от TikTok, если публикация не удалась.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: tt_video_5530" \
-d '{
"text": "Behind the scenes of our new store #opening",
"media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
"disable_comment": false,
"publish_at": "2026-11-10T18:00:00-05:00"
}'Видеопост или фотопост: что нужно для каждого?
Пост в TikTok состоит из одного видео или набора изображений, но не из того и другого вместе, и ссылку в нём не разместить. Текст, до 2 200 символов в easyCoexistence, служит подписью для обоих типов, а правила TikTok для файлов проверяются до постановки поста в очередь:
| Video post | Photo post | |
|---|---|---|
| Media | One video, MP4, MOV or WebM | 1 to 35 images, JPEG or WebP |
| Size | Up to 1 GB, 3 to 600 seconds, at least 360 px | Up to 20 MB per image |
| Title | None; the caption only | title, up to 90 characters |
| Comments | disable_comment turns them off | disable_comment turns them off |
Где должны храниться медиафайлы?
Где угодно по HTTPS или в хранилище easyCoexistence. TikTok загружает файлы только с префиксов URL, подтверждённых для приложения, поэтому easyCoexistence отдаёт каждый файл со своего подтверждённого префикса, и вам ничего подтверждать не нужно. Медиа запланированного поста копируется в момент планирования: изображения до 30 МБ, видео до 1 ГБ, поэтому ссылка, которая перестанет работать до времени публикации, не сможет сломать пост. Чтобы загрузить файл напрямую, POST /media возвращает media_id.
Как узнать, что пост опубликован?
По статусу поста и событиям. Пост переходит из состояния scheduled в publishing, затем в processing, пока TikTok загружает и проверяет файл; easyCoexistence запрашивает у TikTok статус каждые 20 секунд, пока тот не сообщит, что пост готов. Затем ваш URL для событий получает post.published с постом и его каналом или post.failed с причиной от сети. GET /posts/{id} показывает то же, а после публикации также network_post_id и permalink.
Как работают правки, отмена и повторы?
Правки, отмена и повторы работают для поста, пока TikTok его ещё не получил. PATCH /posts/{id} меняет publish_at, text или title у запланированного поста; чтобы изменить медиа, отмените его через DELETE /posts/{id} и создайте новый. POST /posts/{id}/retry публикует неудачный пост повторно. Если TikTok не подтвердит получение в течение 2 часов, пост завершается с may_be_published, равным true, и для повтора нужно задать confirm равным true.
Что происходит с комментариями после публикации?
Они могут дойти до вашего продукта. PUT /channels/{id}/webhook пересылает события comment.update от TikTok на ваш эндпоинт с подписью, а ваш бэкенд отвечает на комментарий через TikTok business/comment/reply/create/, используя токен из вызова credentials. Ответы в TikTok публичны, поскольку подключение TikTok не включает личные сообщения (DM).
Распространённые ошибки
- Отправка PNG для фотопоста. TikTok принимает только JPEG или WebP, поэтому пост отклоняется до постановки в очередь.
- Заголовок у видеопоста. title предназначен для фотопостов, а видео несёт текст только в подписи.
- Повтор поста с may_be_published, равным true, без проверки. TikTok мог уже опубликовать пост, поэтому проверьте аккаунт, прежде чем повторять с confirm.
- Планирование более 15 постов в день на один аккаунт. TikTok ограничивает посты через API на аккаунт, поэтому распределите календарь клиента по дням.
easyCoexistence добавляет публикацию в TikTok в ваш SaaS: клиенты подключают свои аккаунты TikTok по размещённой ссылке, а ваш бэкенд публикует видео и фотопосты сразу или позже, узнаёт, когда каждый опубликован, и получает комментарии к нему. Тот же API работает с WhatsApp, Instagram, Facebook, YouTube, LinkedIn и другими каналами, а каждое подключение находится под мониторингом круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли мой SaaS публиковать видео в TikTok как черновики?
Нет. Эндпоинт постов easyCoexistence публикует видео на аккаунт сразу или в publish_at. Используйте планирование, чтобы удержать пост до готовности клиента.
Позволяет ли TikTok планировать посты через свой API?
Эндпоинты публикации TikTok действуют в момент вызова. easyCoexistence хранит пост в своей очереди и вызывает TikTok в publish_at, до 90 дней вперёд.
Может ли мой SaaS отключить комментарии к посту в TikTok?
Да. Установите disable_comment в true для поста. Если настройки самого аккаунта уже отключают комментарии, TikTok принимает только true.
Сколько стоит easyCoexistence за аккаунт TikTok?
Каждый аккаунт TikTok, который подключают ваши клиенты, стоит от US$ 9 до US$ 0,75 в месяц по диапазону общего числа подключений; первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на