tiktok/
user-audience

Узнавайте, в каких странах живут подписчики публичного аккаунта TikTok, по одному имени пользователя: название страны, ISO-код, доля аудитории и число подписчиков в выборке.

TikTok Audience Demographics API

Поиск по имени пользователя
Страны подписчиков
Доля по каждой стране
20 кредитов за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

Отправьте имя пользователя, опрашивайте задачу и прочитайте одну запись об аудитории.

  1. Отправьте {"username": "khaby.lame"} методом POST на /v1/tiktok/user-audience.
  2. Опрашивайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
  3. Прочитайте единственную запись в 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: кампании обычно нацелены на регион, а не на одну страну.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

TikTok Audience Demographics API — FAQ

TikTok Audience Demographics API — это программный интерфейс для получения стран, в которых находятся подписчики публичного аккаунта TikTok, по его имени пользователя. Он возвращает одну запись со списком стран, где для каждой указаны название, ISO-код, доля аудитории и число подписчиков в выборке.

Да, для любого публичного аккаунта. TikTok показывает местоположение подписчиков только владельцу аккаунта, а для этого поиска нужно лишь имя пользователя.

Нет. Запись охватывает только страну подписчиков, без разбивки по возрасту, полу или городу.

Да, отправьте свое имя пользователя и получите страны в виде данных, не открывая TikTok Analytics, — это удобно для отчетов по нескольким аккаунтам, которыми вы управляете.

Каждая доля рассчитана по выборке подписчиков аккаунта, а count показывает, сколько подписчиков из выборки стоит за ней. Страна с небольшим count — это примерный сигнал, а не точная цифра.

За запрос. Одно имя пользователя стоит фиксированные 20 кредитов независимо от того, сколько стран вернется, а если имени пользователя не существует, задача завершается ошибкой и кредиты возвращаются.