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

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

Чтобы опубликовать видео через TikTok API for Business, отправьте POST на /business/video/publish/ с business_id аккаунта, video_url на подтверждённом домене или префиксе URL и объектом post_info с подписью и настройками, а также заголовком Access-Token. TikTok вернёт share_id; передайте его как publish_id в /business/publish/status/, пока статус не станет PUBLISH_COMPLETE и не появятся post_ids.

easyCoexistence публикует видео в TikTok с помощью publish_tiktok_post из Claude, ChatGPT или вашего собственного агента: передайте HTTPS-ссылку, подпись и то, включены ли комментарии, а затем отслеживайте публикацию через get_tiktok_publish_status.

share_id

Возвращается вызовом публикации, например v_pub_url~v1.2345123456789123456, и передаётся в вызов статуса как publish_id.

Nov 16, 2023

С тех пор TikTok отказывает в публикации видео с URL, домен или префикс которых не подтверждён.

6 a minute

Лимит TikTok на публикации видео для одного аккаунта через эндпоинт публикации: не более 15 в день.

3 min

Сколько может занять появление post_ids после PUBLISH_COMPLETE; TikTok советует повторить запрос через три минуты.

post_id

Приходит в вебхуке post.publish.publicly_available, когда публикация проходит модерацию, и её показатели можно запрашивать.

Что нужно до первого вызова?

Три вещи. Токен доступа аккаунта TikTok и open_id аккаунта, полученные при обмене на токен; приложение разработчика с правом «Video Publish» в разделе TikTok Accounts; и видео по публичному HTTPS или HTTP URL, который находится под доменом или префиксом URL, подтверждённым для приложения. TikTok сам скачивает файл, поэтому он должен оставаться доступным. TikTok рекомендует URL, который действует не меньше 30 минут.

Как выглядит запрос на публикацию?

POST на https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ с токеном аккаунта в заголовке Access-Token и Content-Type application/json. В JSON-теле business_id указывает аккаунт, video_url указывает файл, а настройки публикации задаются в post_info. Этот пример публикует видео с подписью, при этом комментарии, Duet и Stitch остаются включёнными:

Publish a video with curl
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

Что делает каждое поле тела запроса?

Поля, которые справочник TikTok приводит для публикации видео, от верхнего уровня к вложенным. В этом же теле находятся обложка, метка контента, созданного ИИ, местоположение, черновики и вариант «только для рекламы»:

  • business_id: open_id аккаунта, полученный при обмене на токен.
  • video_url: файл, который скачивает TikTok, в формате MP4, MOV или WebM, под подтверждённым доменом или префиксом URL.
  • post_info: обязателен в каждом вызове, даже пустым объектом, и содержит настройки публикации.
  • post_info.caption: до 2 200 символов по подсчёту UTF-16, с #хештегами и до 30 упоминаний через @.
  • post_info.is_brand_organic и is_branded_content: метки «Promotional content» и «Paid partnership», которые в таблице TikTok помечены как обязательные.
  • post_info.disable_comment, disable_duet и disable_stitch: true отключает комментарии, Duet или Stitch; по умолчанию все три равны false.

Что возвращает TikTok?

Стандартная оболочка ответа с ID задачи публикации в поле data. Код 0 означает, что TikTok принял задачу, но не то, что видео уже опубликовано: TikTok ещё должен скачать файл, проверить его и пропустить пост через модерацию. В примерах TikTok share_id видео начинается с v_pub_url, а у фото-поста с p_pub_url.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

Как отслеживать публикацию до того, как она станет доступна?

С помощью GET /business/publish/status/, передавая business_id и share_id как publish_id. Статус принимает значение PROCESSING_DOWNLOAD, пока TikTok загружает файл, PUBLISH_COMPLETE, когда пост прошёл модерацию, или FAILED с указанием причины. post_ids появляется вместе с PUBLISH_COMPLETE, когда пост доступен для просмотра, и может отставать до трёх минут. Весь процесс на Python:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

Может ли вебхук заменить проверки статуса?

Да, для приложения, которое подписывается на event_type VIDEO через /business/webhook/update/. TikTok тогда отправляет post.publish.failed или post.publish.complete, когда скачает и проверит файл; post.publish.publicly_available с новым post_id, когда пройдена модерация; и post.publish.no_longer_publicly_available, если пост позже перестанет быть публичным. В каждом событии задача указана в publish_id, и это то же значение, что и share_id.

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

Попросите простыми словами Claude, ChatGPT или другой клиент, подключённый к https://easycoexistence.com/api/mcp. Ассистент вызывает publish_tiktok_post с account_id из list_social_accounts, HTTPS-ссылкой video_url, подписью и, если нужно отключить комментарии, параметром disable_comment. Результат содержит share_id от TikTok, а get_tiktok_publish_status по account_id и этому share_id возвращает статус, post_ids и reason в текущем состоянии.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

Что publish_tiktok_post отправляет в TikTok?

Вызов того же эндпоинта, заполненный по вашему запросу. Ваша ссылка уходит в TikTok как подписанная ссылка через собственный подтверждённый медиамаршрут easyCoexistence, поэтому отдельное подтверждение не нужно. Подпись и disable_comment передаются так, как вы их указали; is_brand_organic и is_branded_content передаются как false. Остальные настройки, например Duet, Stitch, обложка и метка контента, созданного ИИ, остаются со значениями TikTok по умолчанию, а видео публикуется как публичный пост, как и предусмотрено эндпоинтом.

Что можно делать с учётными данными из Partner API?

Обращаться к TikTok напрямую от имени аккаунта. GET /channels/{id}?credentials=1 на https://easycoexistence.com/api/v1 с вашим ключом ec_live_ как bearer-токеном возвращает канал с объектом credentials: api_base, business_id, актуальный access_token и token_expires_at. Проверки статуса, списки видео, комментарии и показатели затем работают из вашего кода. Публикацию нужно продумать заранее: прямой вызов публикации передаёт video_url в TikTok без изменений, свойства URL добавляются с собственными ID и секретом приложения разработчика, а префикс, подтверждённый приложением easyCoexistence, ведёт на его медиамаршрут, который использует publish_tiktok_post.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

Как настроить

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

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

  • Пропуск post_info. TikTok требует этот объект в каждом вызове, даже если ни одна настройка не меняется.
  • Поиск ID поста в ответе на публикацию. Ответ содержит только share_id; ID постов приходят из вызова статуса или из вебхука post.publish.publicly_available.
  • Повторный вызов публикации после тайм-аута. Первый запрос мог дойти до TikTok, поэтому сначала проверьте последние посты аккаунта, а потом отправляйте его снова.
  • Считать код 0 признаком опубликованного видео. Он означает, что TikTok принял задачу, а файл после загрузки всё ещё может не пройти проверку.
Настройка с EasyCoexistence

Файл попадает в TikTok через подтверждённый медиамаршрут. Цена от US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений, с бесплатным пробным периодом на 3 дня.

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

Какой эндпоинт публикует видео в TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, с токеном аккаунта в заголовке Access-Token и полями business_id, video_url и post_info в JSON-теле.

Может ли TikTok API загрузить видеофайл напрямую?

Не через /business/video/publish/. Эндпоинт принимает video_url и сам забирает файл по ссылке, поэтому видео должно лежать по URL под подтверждённым доменом или префиксом URL.

Как получить ID видео, опубликованного через API?

Из post_ids в /business/publish/status/, когда статус равен PUBLISH_COMPLETE и пост публичный, или из post_id в вебхуке post.publish.publicly_available.

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

Эндпоинт публикации выкладывает пост в момент вызова и не имеет поля для времени. easyCoexistence хранит отложенные посты в собственной очереди и вызывает TikTok в то время, которое вы задали.

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

Настройки публикации TikTok через API: приватность, комментарии, Duet и StitchНастройки, которые принимают эндпоинты публикации TikTok: приватность, комментарии, Duet, Stitch, обложка, маркировки и допустимые значения аккаунта.Медиа-ссылки TikTok: проверенные домены и префиксы URLКак TikTok API for Business загружает медиа с проверенных доменов и префиксов URL: проверка через DNS TXT, файл подписи и эндпоинты подтверждения.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.Требования к видео для TikTok API: формат, размер и длинаВидео для API for Business от TikTok: MP4, MOV или WebM, от 3 до 600 секунд, до 1 ГБ, 23–60 FPS, по URL, который TikTok загружает сам.Настройка вебхуков TikTok API for BusinessКак подписать приложение TikTok API for Business на вебхуки: /business/webhook/update/, события VIDEO и COMMENT, правила callback и Tiktok-Signature.Токены доступа TikTok API for Business: 24 часа, обновление и отзывКак TikTok API for Business выдаёт токены аккаунта: обмен auth_code, токен доступа на 24 часа, токен обновления на год, обновление и отзыв.

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

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

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

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