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

Как добавить публикацию в TikTok в ваш SaaS

Чтобы добавить публикацию в TikTok, SaaS подключает TikTok аккаунт каждого клиента по размещённой ссылке, затем вызывает POST /channels/{id}/posts в easyCoexistence с одним видео или 1–35 изображениями и подписью, сразу или с датой publish_at до 90 дней вперёд. Пост уходит через API for Business от TikTok, который разрешает 15 постов в день на аккаунт, а ваш бэкенд узнаёт, когда пост опубликован.

15 a day

Видеопосты, которые TikTok публикует на аккаунт через API for Business, не более шести в минуту.

1 GB

Наибольшее видео, которое принимает эндпоинт публикации TikTok: MP4, MOV или WebM, длиной от 3 до 600 секунд.

35 images

Наибольшее число изображений в одном фотопосте TikTok; каждое JPG, JPEG или WebP, до 20 МБ.

90

Единицы кода UTF-16, которые может содержать заголовок фотопоста TikTok.

90 days

На сколько вперёд эндпоинт постов 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, если публикация не удалась.

Schedule a TikTok video
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 postPhoto post
MediaOne video, MP4, MOV or WebM1 to 35 images, JPEG or WebP
SizeUp to 1 GB, 3 to 600 seconds, at least 360 pxUp to 20 MB per image
TitleNone; the caption onlytitle, up to 90 characters
Commentsdisable_comment turns them offdisable_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

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 дня бесплатно.

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

Единое API соцсетей для SaaS: одна интеграция для WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналовОдна интеграция для WhatsApp, Instagram, Facebook, TikTok, YouTube и LinkedIn клиентов: что объединено, что решает каждая сеть, вызовы API.Как позволить клиентам подключить Instagram к вашему приложениюРазмещённая ссылка для аккаунтов Instagram ваших клиентов: вызов сессии, токен и публикация, ответы на комментарии и DM из вашего приложения.Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.Как получать сообщения клиентов WhatsApp и комментарии соцсетей по вебхукуВебхук на каждое подключение: сообщения WhatsApp напрямую от Meta, защита секретом в URL, а комментарии и DM соцсетей подписаны X-EC-Signature.

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

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

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

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