TikTok Audience Demographics
Страны аудитории аккаунта TikTok показывают, где живут его подписчики: для каждой страны указывается ее доля в выборке подписчиков и число подписчиков из выборки, на котором основана эта доля. Встроенная аналитика TikTok показывает эти данные только владельцу аккаунта, поэтому бренды, агентства и аналитики проверяют автора, которым не управляют, через поиск по имени пользователя.
Возможности TikTok Audience Demographics API
- Любое публичное имя пользователя без входаОтправьте публичное имя пользователя, с @ или без, и получите географию подписчиков без доступа к аккаунту и без сессии TikTok.
- Название, ISO-код, доля и количествоКаждая запись audience_countries содержит название страны, двухбуквенный country_code, долю от 0 до 1 и число подписчиков в выборке, на котором она основана.
- Крупнейший рынок первымСтраны упорядочены по доле, поэтому первые строки показывают, где находится большая часть аудитории, а хвост списка — более мелкие рынки.
Параметры TikTok Audience Demographics API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Имя пользователя TikTok для анализа, с начальным @ или без него. |
Как использовать TikTok Audience Demographics API
Отправьте имя пользователя, опрашивайте задачу и прочитайте одну запись об аудитории.
- Отправьте {"username": "khaby.lame"} методом POST на /v1/tiktok/user-audience.
- Опрашивайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
- Прочитайте единственную запись в results.items и переберите audience_countries.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"khaby.lame"}'
# The result has one record; audience_countries[].share is a fraction from 0 to 1.Сценарии использования TikTok Audience Demographics API
- Выбор автора для одного рынка: Прежде чем платить за кампанию, нацеленную на одну страну, посмотрите, какую долю эта страна занимает среди подписчиков автора: большая аудитория, живущая в других странах, не дойдет до ваших покупателей.
- Проверка эффективности геотаргетинга: Если вы пытаетесь нарастить аудиторию в новой стране, запускайте одно и то же имя пользователя по расписанию и сравнивайте долю этой страны между метками времени collected_at.
- Исключение рынков, которые вы не обслуживаете: Магазины и приложения, которые продают в фиксированном списке стран, могут сложить доли этих значений country_code и отсеять авторов, чьи подписчики в основном живут за их пределами.
Практические советы по TikTok Audience Demographics API
- Разделите count на share, чтобы понять размер выборки подписчиков; если она маленькая, считайте страны с близкими долями равными, а не выстраивайте их по местам.
- Перед сравнением авторов группируйте значения country_code в собственные регионы, например EU или LATAM: кампании обычно нацелены на регион, а не на одну страну.
Связанные API
Помимо TikTok Audience Demographics API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
- TikTok Followers List API — Собирайте нормализованные профили из публичных списков подписчиков с сохраненным контекстом источника и поддерживаемыми метриками.
- TikTok Following List API — Собирайте публичные профили, на которые подписаны аккаунты TikTok: нормализованные данные аккаунта, описания, видимые метрики и контекст исходного аккаунта.
- TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
- TikTok Similar Accounts API — Получайте аккаунты, которые TikTok рекомендует как похожие на заданный, с числом подписчиков и описанием профиля.
- TikTok Live Ranking API — Получайте ежедневный рейтинг ведущих прямых эфиров: места, баллы за подарки и число подписчиков.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API