Демография аудитории TikTok через API
API TikTok for Business возвращает демографию подписчиков аккаунта из GET /business/get/: audience_ages, audience_genders, audience_countries и audience_cities, каждое как список долей подписчиков, для аккаунтов от 100 подписчиков. Почасовая активность подписчиков приходит как audience_activity в metrics каждого дня, для аккаунтов с Advanced Access или Verified Business Accounts, у которых тоже от 100 подписчиков. Все поля требуют области доступа user.insights.
easyCoexistence читает демографию подписчиков аккаунта TikTok через get_social_insights из Claude, ChatGPT или вашего кода: запросите audience_ages, audience_genders, audience_countries, audience_cities или audience_activity, и вы получите списки TikTok в исходном виде.
Количество подписчиков, которое аккаунту нужно, чтобы TikTok вернул разбивку по возрасту, полу, стране и городу.
Возрастные группы в audience_ages: 18-24, 25-34, 35-44, 45-54 и 55+.
Часовой пояс audience_activity: почасовое число подписчиков, активных в TikTok.
Обычная задержка для audience_countries, audience_genders и audience_activity, которые TikTok считает в фоновом режиме.
Какие демографические данные возвращает эндпоинт аккаунта?
GET /business/get/ возвращает их, если они перечислены в fields. Четыре разбивки находятся в начале data, по одному списку на каждое измерение, а почасовая активность находится в metrics, по одному набору на каждый день:
audience_ages: доля подписчиков в каждой возрастной группе: 18-24, 25-34, 35-44, 45-54 и 55+.audience_genders: доля подписчиков по полу: Female, Male или Other.audience_countries: доля подписчиков по странам или регионам в виде кода ISO 3166-1 alpha-2.audience_cities: доля подписчиков по городам, поcity_name.audience_activity: для каждого дня количество подписчиков, активных в TikTok в каждый час, в виде hour и count.
Как их запросить?
Передайте имена полей в fields в виде JSON-массива, а также диапазон дат в UTC для ежедневных metrics, в которых есть audience_activity. start_date и end_date охватывают до 60 дней назад; если их не указать, TikTok вернёт 7 дней до дня, предшествующего запросу:
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=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
--data-urlencode 'start_date=2026-10-24' \
--data-urlencode 'end_date=2026-10-30'Как выглядит ответ?
Каждая разбивка выглядит как список объектов, где группа указана вместе со своим процентом, а каждый день в metrics содержит дату и список audience_activity с часами. Значения ниже взяты из примеров самого TikTok и сокращены до списка по полу и нескольких часов:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"audience_genders": [
{ "gender": "Female", "percentage": 0.7554470336505679 },
{ "gender": "Male", "percentage": 0.24455296634943213 }
],
"metrics": [
{
"date": "<DATE>",
"audience_activity": [
{ "hour": "20", "count": 1 },
{ "hour": "23", "count": 4 },
{ "hour": "7", "count": 4 }
]
}
]
}
}Какие аккаунты получают какие разбивки?
Доли по возрасту, полу, стране и городу появляются, когда у аккаунта от 100 подписчиков. Пример TikTok для аккаунта с 13 подписчиками возвращает эти списки пустыми. audience_activity тоже требует 100 подписчиков, а также аккаунт с Advanced Access, который получается при привязке к TikTok for Business или к непроверенному Business Center, либо Verified Business Account. Каждое из этих полей требует области доступа user.insights в токене.
Насколько свежи демографические данные?
С задержкой в день или два. TikTok относит audience_countries, audience_genders и audience_activity к полям, которые обычно отстают на 24–48 часов, в UTC, и указывает то же время обновления для возрастов и городов. Данные берутся из TikTok Analytics, который владелец аккаунта включает в приложении после публикации первого видео; данные за период до этого недоступны. TikTok рассчитывает демографию на основе нескольких факторов, в том числе того, что пользователи указывают в своих профилях.
Чем демография подписчиков отличается от зрителей видео?
Они описывают разных людей. Разбивки аккаунта относятся к подписчикам. /business/video/list/ возвращает разбивки людей, которые посмотрели один пост: audience_genders, audience_countries и audience_cities, до 10 записей в каждой, а также audience_types, которая делит зрителей на новых и вернувшихся, подписчиков и тех, кто не подписан. Для них нужна область доступа video.insights вместо user.insights.
Как easyCoexistence читает их?
С помощью get_social_insights для аккаунта: не указывайте object_id, перечислите имена полей как metrics и передайте start_date и end_date в params, если нужна audience_activity за конкретные дни. Инструмент возвращает списки TikTok в исходном виде, поэтому доли и часы читаются точно так же, как описано выше.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
"params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}Распространённые ошибки
- Ожидание разбивок для небольшого аккаунта. TikTok возвращает доли по возрасту, полу, стране и городу от 100 подписчиков, а его пример для аккаунта с 13 подписчиками показывает пустые списки.
- Чтение часов audience_activity как местного времени. TikTok указывает их в UTC+0, поэтому переведите их в часовой пояс аудитории перед планированием публикаций.
- Восприятие демографии подписчиков как демографии зрителей. Списки аккаунта описывают подписчиков, а audience_countries видео описывает людей, которые его посмотрели.
- Ожидание audience_activity на личном аккаунте. TikTok возвращает её для аккаунтов с Advanced Access или Verified Business Accounts, у которых от 100 подписчиков.
От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли API TikTok показать возраст и пол моих подписчиков?
Да. /business/get/ возвращает audience_ages и audience_genders, доли подписчиков по группам, когда у аккаунта от 100 подписчиков и у токена есть область user.insights.
Какие возрастные группы использует API TikTok?
18-24, 25-34, 35-44, 45-54 и 55+, для каждой указана доля подписчиков в ней.
Показывает ли API TikTok, когда мои подписчики онлайн?
audience_activity даёт количество подписчиков, активных в TikTok, по часам, в UTC+0, внутри metrics каждого дня, для аккаунтов с Advanced Access или Verified Business Accounts, у которых 100 подписчиков и более.
Как API TikTok указывает страны подписчиков?
В виде кодов стран или регионов ISO 3166-1 alpha-2 в audience_countries, каждый с долей подписчиков оттуда.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на