Количество подписчиков TikTok и данные профиля через API
TikTok API for Business возвращает количество подписчиков как followers_count из GET /business/get/ вместе с username, display_name, profile_image, bio_description, is_verified, following_count, total_likes и videos_count. Для каждого поля нужен свой scope, например user.info.stats. Display API в /v2/user/info/ возвращает то же значение как follower_count для пользователя, который авторизовал приложение.
easyCoexistence читает профиль и количество подписчиков аккаунта TikTok через get_social_insights из Claude, ChatGPT или вашего кода: назовите поля, например followers_count, total_likes или videos_count, с датами для ежедневных строк, и получите цифры TikTok как они есть.
Scope для followers_count, following_count, total_likes и videos_count указан в начале /business/get/.
Как TikTok обновляет followers_count и поля профиля, и что ежедневные метрики обычно приходят через 24–48 часов.
Название счётчика в /v2/user/info/ в Display API и его собственный scope user.info.stats.
Максимальный период для ежедневного followers_count и других ежедневных метрик в /business/get/.
Что возвращает /business/get/, если запрос не называет поля: display_name и profile_image.
Какие поля профиля возвращает /business/get/?
Те, что перечислены в fields, JSON-массиве в строке запроса. Каждое открывается scope, который владелец аккаунта выдал при авторизации приложения. Запрос без полей получает только display_name и profile_image. TikTok обновляет поля профиля и счётчиков ниже в реальном времени:
Как запросить количество подписчиков?
GET-запросом к /business/get/, с токеном аккаунта в заголовке Access-Token, business_id, которым служит open_id из обмена токена, и нужными полями. Текущие значения находятся в начале data, а данные по каждому дню в metrics:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}Как отслеживать подписчиков по дням?
Укажите followers_count в fields, и TikTok вернёт его дважды: общее значение за всё время в начале data, в user.info.stats, и итог за каждый день внутри metrics, в user.insights. start_date и end_date в UTC задают дни, до 60 назад. Без них TikTok возвращает последние 7 дней до дня, предшествующего запросу. Три ежедневных поля показывают движение, стоящее за итогом, для аккаунтов с Advanced Access или Verified Business Account:
daily_new_followers: подписчики, прибавившиеся за день.daily_lost_followers: подписчики, ушедшие за день.daily_total_followers: чистый прирост за день, приросты минус отписки.
Что возвращает Display API?
Тот же тип профиля для пользователя, который авторизовал приложение из TikTok for Developers. Запрос идёт GET https://open.tiktokapis.com/v2/user/info/ с полями, перечисленными в параметре fields. Названия и scope у него отличаются от API for Business, а объект user не содержит истории по дням:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
Можно ли получить количество подписчиков чужого аккаунта?
Не с помощью этих двух эндпоинтов. /business/get/ отвечает для business_id аккаунта, который авторизовал приложение, а /v2/user/info/ для пользователя, чей токен делает вызов. У Research API TikTok есть эндпоинт /v2/research/user/info/, который принимает имя пользователя и возвращает follower_count, following_count, likes_count и video_count, но только для исследователей, одобренных TikTok.
Как easyCoexistence читает профиль?
С помощью get_social_insights для аккаунта, без object_id: названия в metrics становятся полями /business/get/, start_date и end_date в params выбирают дни, а результат приходит в виде данных TikTok как есть. Пустой список metrics запрашивает имя пользователя, отображаемое имя, фото, счётчики подписчиков, подписок, лайков и видео, два флага уровня аккаунта и ежедневные просмотры видео, просмотры профиля и новых подписчиков. list_social_accounts показывает также имя пользователя и отображаемое имя, сохранённые при подключении аккаунта.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}Распространённые ошибки
- Запрос followers_count без user.info.stats в токене. TikTok возвращает каждое поле только тогда, когда владелец выдал его scope, поэтому владельцу нужно авторизовать приложение заново.
- Сохранение profile_image на будущее. Это временный URL, срок действия которого указан в параметре x-expires, поэтому при необходимости запрашивайте свежий.
- Чтение follower_count из /business/get/. Так называется поле Display API; API for Business называет его followers_count.
- Ожидание новых и ушедших подписчиков на личном аккаунте. TikTok возвращает эти ежедневные поля для Advanced Access или Verified Business Account.
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Может ли API TikTok показать рост подписчиков за время?
Да, за период до 60 дней: followers_count по каждому дню в metrics, плюс ежедневные новые, ушедшие и чистые подписчики на Advanced Access или Verified Business Account.
Какой scope нужен для количества подписчиков TikTok?
user.info.stats, в обоих API: он открывает followers_count в /business/get/ и follower_count в /v2/user/info/ Display API.
Возвращает ли личный аккаунт TikTok количество подписчиков?
Да. followers_count зависит от scope, а не от уровня аккаунта; только некоторые ежедневные поля требуют Advanced Access или Verified Business Account.
Как часто обновляется количество подписчиков TikTok?
TikTok отмечает followers_count верхнего уровня как реальное время, а ежедневные строки в metrics обычно приходят с задержкой 24–48 часов, в UTC.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на