API аналитики TikTok: показатели аккаунта и видео
API for Business от TikTok возвращает показатели аккаунта по дням, включая подписчиков, просмотры видео, просмотры профиля, лайки, комментарии и репосты, за период не более 60 дней, а также суммарные показатели каждого видео: просмотры, лайки, комментарии и репосты. Большинство показателей поступает с задержкой 24–48 часов и требует, чтобы в приложении был включён TikTok Analytics.
easyCoexistence читает аналитику TikTok через get_social_insights из Claude, ChatGPT или вашего собственного кода: подписчики, просмотры и лайки аккаунта по дням либо просмотры, лайки, комментарии и репосты видео.
Максимальная глубина ежедневных показателей аккаунта; без дат API возвращает данные за последние 7 дней.
Обычная задержка до появления ежедневных показателей и показателей публикаций: лайков, просмотров и репостов.
Срок после публикации, по истечении которого данные публикации перестают обновляться.
Количество подписчиков, необходимое для того, чтобы 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, поэтому его значение выше.
Для других полей аналитики 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, охватывает органическую и платную активность вместе.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на