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

Scope в TikTok API for Business: что открывает каждое разрешение

API for Business у TikTok даёт доступ на двух уровнях. Приложение разработчика получает разрешения в TikTok Accounts, например Video Publish и Manage Account Comment, которые открывают эндпоинты. Авторизация владельца аккаунта выдаёт токену доступа scope, например user.insights и video.list, которые определяют возвращаемые поля. /tt_user/token_info/get/ перечисляет scope, которые несёт токен.

easyCoexistence запрашивает у владельца аккаунта TikTok разрешения, которые держит его приложение, одним входом, поэтому Claude, ChatGPT или ваш собственный код могут публиковать, работать с комментариями и читать аналитику через его инструменты, а get_social_credentials даёт вашему коду тот же токен для других эндпоинтов Accounts API.

18000000

Scope ID для TikTok Accounts: разрешение первого уровня над эндпоинтами Accounts API для профиля, постов, комментариев и публикации.

user.account.type

Scope, за которым стоят is_business_account и has_advanced_access в данных профиля аккаунта.

comment.list

Scope, который владелец должен выдать и сохранять активным, чтобы приложение получало вебхуки comment.update.

video.upload

Scope, нужный токену, чтобы загружать пост как черновик, а не публиковать его.

2 to 3 days

Рабочие дни, которые может занимать проверка TikTok изменения разрешений приложения разработчика.

Какие бывают два уровня разрешений TikTok?

Разрешения приложения и scope токена. Разрешения приложения выбираются в «My Apps», в приложении, в разделе «Scope of permission», и TikTok их проверяет; они бывают трёх уровней, и разрешение первого уровня покрывает все эндпоинты ниже. Scope токена представляет собой то, что владелец аккаунта одобрил при авторизации приложения; они возвращаются в поле scope одной строкой через запятую, с каждым токеном. Вызову нужно разрешение приложения для его эндпоинта, а некоторым полям ответа также нужен scope на токене.

Какое разрешение приложения открывает каждый эндпоинт?

Справочник API TikTok для каждого эндпоинта Accounts API указывает разрешение в TikTok Accounts, которое его открывает, либо разрешения нет. Справочник по scope разрешений и руководство по вебхукам называют те же группы Business User, Business Media, Business Comment и Business Content, поэтому ожидайте оба набора названий:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Какие scope токена открывают какие поля?

Справочники TikTok по /business/get/ и /business/video/list/ указывают обязательное разрешение для каждого поля ответа, а две другие функции имеют собственный scope:

  • user.info.basic: display_name и profile_image.
  • user.info.username: username, которому до июня 2023 года требовался user.info.basic.
  • user.info.profile: profile_deep_link, bio_description и is_verified.
  • user.info.stats: following_count, followers_count, total_likes и videos_count.
  • user.account.type: is_business_account и has_advanced_access.
  • user.insights: ежедневные метрики аккаунта и разбивка подписчиков по возрасту, полу, стране и городу.
  • video.list: поля постов, например item_id, caption, share_url, likes, comments, shares, reach и video_views.
  • video.insights: время просмотра, долю полного просмотра, удержание, источники трафика, разбивку зрителей и клики, которые приносит пост.
  • comment.list: вебхук comment.update, который TikTok описывает как чтение комментариев и ответов на контент в приложении.
  • video.upload: загрузка видео- или фотопоста как черновика, с upload_to_draft или is_draft.

Как посмотреть scope токена?

Запросите /tt_user/token_info/get/, который принимает app_id и токен доступа и возвращает scope токена и creator_id аккаунта. Примеры строк scope у TikTok также включают video.publish и comment.list.manage, чьи названия совпадают с эндпоинтами публикации и управления комментариями, хотя справочники TikTok не связывают с ними ни одного поля.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

Что запрашивает подключение easyCoexistence к TikTok?

Все разрешения, которые держит его приложение разработчика, и все они показываются на странице согласия TikTok. easyCoexistence отправляет владельца аккаунта на URL авторизации держателя аккаунта TikTok, который генерирует портал TikTok для его приложения, который уже называет эти разрешения, и добавляет только собственное значение state. Владелец одобряет то, что показывает TikTok, а строка scope, которую возвращает TikTok, сохраняется вместе с подключением. Эндпоинты, которые easyCoexistence затем вызывает для аккаунта:

  • /business/get/ для профиля, ежедневных метрик и разбивки подписчиков.
  • /business/video/list/ для постов и их метрик.
  • /business/video/publish/, /business/photo/publish/ и /business/publish/status/ для публикации.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ и /business/comment/delete/ для комментариев.
  • /business/webhook/update/ на уровне приложения для вебхука комментариев.

Как добавить разрешение позже?

В два шага, по одному на каждый уровень. Для приложения откройте «My Apps», приложение, «Scope of permission», измените его, укажите причину, соответствующую новым scope, и отправьте на проверку. Проверка TikTok может занять два–три рабочих дня, а с 20 марта 2026 г. запрос, включающий TikTok Accounts, сначала требует Accounts API Access Application Form. Для токена владелец авторизует приложение заново, так как токен сохраняет scope, одобренные при его выдаче.

Что происходит, когда разрешения нет?

Для вызова код ошибки TikTok 40001 означает, что нет разрешения на выполнение связанной операции, а исправление ссылается на справочник scope разрешений. Для поля справочники делают его доступным только после того, как владелец выдал его scope, и исправление состоит в том, чтобы владелец авторизовал приложение заново с этим scope. Проверьте scope токена через /tt_user/token_info/get/, прежде чем просить об этом владельца.

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

  • Ожидание, что подключённые аккаунты сами получат новое разрешение приложения. Их токены сохраняют scope, одобренные при авторизации, пока каждый владелец не авторизует приложение заново.
  • Запрос is_business_account без user.account.type. TikTok делает это поле и has_advanced_access доступными только токенам, которые несут этот scope.
  • Ожидание comment.update без comment.list. TikTok присылает события комментариев только пока авторизация владельца с этим scope остаётся действительной.
  • Поиск названий разрешений приложения в токене. Строка scope использует названия вроде video.list, а названия вроде Get Account Media относятся к настройкам приложения.
Настройка с EasyCoexistence

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

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

Какие scope использует TikTok API for Business?

Scope токена, такие как user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list и video.upload, которые выдаёт владелец аккаунта поверх разрешений TikTok Accounts приложения.

Какие разрешения нужны вебхуку комментариев TikTok?

Приложению нужны TikTok Accounts и Business Comment, а владелец должен выдать comment.list. События прекращаются, если эта авторизация истекает или отзывается.

Применяется ли новый scope TikTok к уже выданным токенам?

Нет. Токен сохраняет scope, одобренные при его выдаче, поэтому владелец аккаунта авторизует приложение заново, чтобы добавить новый.

Сколько времени TikTok одобряет новое разрешение?

TikTok говорит, что проверка изменения разрешения может занять два–три рабочих дня, а запросы, добавляющие TikTok Accounts, сначала требуют Accounts API Access Application Form.

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

Токены доступа TikTok API for Business: 24 часа, обновление и отзывКак TikTok API for Business выдаёт токены аккаунта: обмен auth_code, токен доступа на 24 часа, токен обновления на год, обновление и отзыв.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Настройка вебхуков TikTok API for BusinessКак подписать приложение TikTok API for Business на вебхуки: /business/webhook/update/, события VIDEO и COMMENT, правила callback и Tiktok-Signature.Метрики видео TikTok через API: просмотры, время просмотра и досмотрыМетрики видео в API for Business TikTok: просмотры, охват, время просмотра, досмотры, удержание, источники показов и страны зрителей.Демография аудитории TikTok через APIДемография подписчиков из API TikTok: доли по возрасту, полу, стране и городу, почасовая активность и порог в 100 подписчиков.API аналитики TikTok: показатели аккаунта и видеоМетрики TikTok из API for Business: подписчики, просмотры и лайки по дням для аккаунта, просмотры, лайки, комментарии и репосты по видео.

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

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

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

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