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

API аналитики TikTok: показатели аккаунта и видео

API for Business от TikTok возвращает показатели аккаунта по дням, включая подписчиков, просмотры видео, просмотры профиля, лайки, комментарии и репосты, за период не более 60 дней, а также суммарные показатели каждого видео: просмотры, лайки, комментарии и репосты. Большинство показателей поступает с задержкой 24–48 часов и требует, чтобы в приложении был включён TikTok Analytics.

easyCoexistence читает аналитику TikTok через get_social_insights из Claude, ChatGPT или вашего собственного кода: подписчики, просмотры и лайки аккаунта по дням либо просмотры, лайки, комментарии и репосты видео.

60 days

Максимальная глубина ежедневных показателей аккаунта; без дат API возвращает данные за последние 7 дней.

24 to 48 h

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

365 days

Срок после публикации, по истечении которого данные публикации перестают обновляться.

100

Количество подписчиков, необходимое для того, чтобы TikTok возвращал разбивку по возрасту, полу и местоположению подписчиков.

Какие показатели аккаунта есть?

GET /business/get/ возвращает профиль аккаунта и, для запрошенных дат, список показателей с одной записью на каждый день, во времени UTC:

  • followers_count: общее число подписчиков сейчас и на каждый день.
  • video_views, profile_views, likes, comments и shares: ежедневные показатели по видео аккаунта.
  • unique_video_views, daily_new_followers, daily_lost_followers и engaged_audience: по дням, для аккаунтов с Advanced Access или Verified Business Accounts.
  • audience_ages, audience_genders, audience_countries и audience_cities: разбивка подписчиков, для аккаунтов не менее чем со 100 подписчиками.

Какие показатели видео есть?

GET /business/video/list/ возвращает публичные публикации аккаунта с суммарными показателями за всё время, без ограничения 60-дневной глубиной данных: video_views, likes, comments, shares и favorites, а также охват, общее и среднее время просмотра, долю полного просмотра, новых подписчиков и источники трафика. Возвращает до 20 публикаций на страницу; filters.video_ids выбирает конкретные.

Насколько свежие данные?

Поля профиля, например имя пользователя и текущее число подписчиков, обновляются в реальном времени. Ежедневные показатели аккаунта и показатели публикаций, такие как просмотры, лайки, комментарии и репосты, обычно отстают на 24–48 часов во времени UTC, а данные публикации перестают обновляться через 365 дней после её выхода. Охват, время просмотра и источники трафика могут отсутствовать у видео, которое более 7 дней никто не смотрел, не отмечал лайком, не комментировал и не репостил.

Почему показатели могут отсутствовать?

API возвращает то, что есть в TikTok Analytics. Владелец аккаунта должен опубликовать хотя бы одно видео и включить Analytics в приложении TikTok; данные за период до включения Analytics недоступны. Некоторым показателям нужно больше: охват аудитории и новые или потерянные подписчики доступны только для аккаунтов с Advanced Access или Verified Business Accounts, а разбивка подписчиков начинается со 100 подписчиков.

Почему числа могут отличаться от приложения TikTok?

Из-за того, что в них входит. video_views учитывает органические и платные просмотры вместе, а shares учитывает и репосты за пределы TikTok, и отправки друзьям внутри приложения, поэтому может быть выше, чем счётчик репостов на сайте TikTok. Дневной показатель лайков не вычитает лайки, снятые позднее.

Как easyCoexistence читает их?

Через get_social_insights. Для аккаунта запросите показатели, например followers_count, video_views и likes, с start_date и end_date: инструмент вернёт строки с данными TikTok по дням. Для одного видео передайте его item_id как object_id, и он вернёт просмотры, лайки, комментарии и репосты; поиск идёт среди 20 последних видео аккаунта. Для более старого видео ваш код вызывает business/video/list/ с filters.video_ids, используя токен из get_social_credentials.

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

  • Считать вчерашние цифры окончательными. Ежедневные показатели могут отставать на 24–48 часов, поэтому последние дни могут ещё дозаполняться.
  • Запрашивать показатели аккаунта за более чем 60 дней. Глубина данных на этом заканчивается, поэтому сохраняйте цифры, если нужна более длинная история.
  • Искать старое видео по object_id. get_social_insights ищет среди 20 последних; для старых публикаций фильтруйте по video_ids из вашего кода, с токеном из get_social_credentials.
  • Сравнивать репосты из API с цифрой на сайте. API учитывает и отправки друзьям внутри TikTok, поэтому его значение выше.
Настройка с EasyCoexistence

Для других полей аналитики TikTok get_social_credentials даёт вашему коду токен аккаунта. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; бесплатный пробный период: 3 дня.

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

Показывает ли API TikTok, сколько подписчиков аккаунт потерял?

Да, как daily_lost_followers рядом с daily_new_followers, для аккаунтов с Advanced Access или Verified Business Accounts.

Как далеко назад уходят показатели аккаунта в TikTok?

На 60 дней. Без дат API возвращает 7 дней до дня, предшествующего запросу, во времени UTC.

Когда перестают обновляться данные видео в TikTok?

Через 365 дней после публикации видео. До этого его суммарные показатели продолжают обновляться, обычно с задержкой 24–48 часов.

Включают ли просмотры видео в TikTok платные просмотры?

Да. Показатель video_views, который возвращает TikTok, охватывает органическую и платную активность вместе.

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

Ответы на комментарии TikTok и модерация через APIКак API TikTok для бизнеса читает и скрывает комментарии, отвечает на них и удаляет свои, а правила по ключевым словам отвечают на новые сами.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.События вебхука комментариев TikTokКак вебхук comment.update от TikTok сообщает о комментариях и ответах, что несёт каждое событие и как оно приходит на ваш эндпоинт с подписью.Ошибка TikTok 40001: нет разрешения на операциюОшибка TikTok 40001 означает, что у вызывающего приложения нет разрешения на операцию. Как проверить разрешение TikTok Accounts у приложения и scope токена.

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

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

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

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