tiktok/
similar-users

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

TikTok Similar Accounts API

Поиск по имени пользователя
Рекомендации TikTok
До 300 аккаунтов
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Similar Accounts

Похожие аккаунты — это профили, которые TikTok рекомендует рядом с автором, и у каждого есть имя пользователя, отображаемое имя, описание профиля, статус верификации и число подписчиков, подписок и видео. Поскольку список строится на группировке самого TikTok, а не на совпадении ключевых слов, это быстрый способ найти похожих авторов для поиска блогеров и анализа конкурентов.

Возможности TikTok Similar Accounts API

  • Порядок рекомендаций самого TikTokПо одному имени пользователя возвращаются аккаунты, которые TikTok показывает рядом с этим автором, в том порядке, в котором TikTok их рекомендует.
  • Размер и надежность в каждой строкеfollowers_count, following_count, posts_count и is_verified приходят с каждым аккаунтом, поэтому отбирать по размеру и верификации можно, не открывая ни одного профиля.
  • До 300 аккаунтов на исходный профильЗапрашивайте от 1 до 300 аккаунтов через results_limit (по умолчанию 30) и читайте их постранично с next_cursor.

Параметры TikTok Similar Accounts API

ПараметрыОбязательныйОписание
usernameОбязательныйИмя пользователя TikTok, для которого ищутся похожие аккаунты, с начальным @ или без него.
results_limitНеобязательныйСколько похожих аккаунтов вернуть, от 1 до 300. По умолчанию 30.

Как использовать TikTok Similar Accounts API

Начните с одного автора и пролистайте по страницам аккаунты, которые рекомендует TikTok.

  1. Отправьте {"username": "khaby.lame", "results_limit": 30} методом POST на /v1/tiktok/similar-users.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте аккаунты из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame","results_limit":30}'

# Each item is one recommended account with username, name and metrics.followers_count.

Сценарии использования TikTok Similar Accounts API

  • Расширение шорт-листа вокруг успешного автора: Возьмите за исходный профиль автора, чья кампания сработала, и оставьте рекомендованные аккаунты, чей followers_count подходит под ваш бюджетный уровень.
  • Кто находится рядом с партнерами конкурента: Используйте авторов, с которыми уже работает бренд-конкурент, как исходные профили и смотрите, какие соседние аккаунты показывает TikTok и каков их размер.
  • Картирование ниши по пересечениям: Запустите нескольких лидеров категории как исходные профили и объедините списки: аккаунты, которые повторяются у разных исходных профилей, образуют ядро ниши.

Практические советы по TikTok Similar Accounts API

  • Объединяйте списки от нескольких исходных профилей по id, а не по username: один и тот же аккаунт появляется у связанных профилей, а имена пользователей могут меняться.
  • Используйте каждое возвращенное имя пользователя как новый исходный профиль, чтобы продвинуться на шаг дальше, и остановитесь, когда новые результаты в основном повторяют уже собранные аккаунты.
  • Начинайте со значения по умолчанию 30 и увеличивайте results_limit, только если большая часть результатов для вас еще новая: каждый возвращенный аккаунт тарифицируется.

Помимо TikTok Similar Accounts API, используйте эти API, когда нужен другой тип публичных данных TikTok.

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Followers List API — Собирайте нормализованные профили из публичных списков подписчиков с сохраненным контекстом источника и поддерживаемыми метриками.
  • TikTok Following List API — Собирайте публичные профили, на которые подписаны аккаунты TikTok: нормализованные данные аккаунта, описания, видимые метрики и контекст исходного аккаунта.
  • TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
  • TikTok Audience Demographics API — Узнавайте по имени пользователя, из каких стран подписчики автора и какую долю аудитории дает каждая страна.
  • TikTok Live Ranking API — Получайте ежедневный рейтинг ведущих прямых эфиров: места, баллы за подарки и число подписчиков.

Другие платформы

Объединяйте данные TikTok с публичными данными других поддерживаемых соцсетей.

TikTok Similar Accounts API — FAQ

TikTok Similar Accounts API — это программный интерфейс для получения аккаунтов, которые TikTok рекомендует как похожие на публичное имя пользователя. Для каждого аккаунта он возвращает имя пользователя, отображаемое имя, описание профиля, аватар, статус верификации и число подписчиков, подписок и видео.

Отправьте имя пользователя этого автора и прочитайте вернувшиеся аккаунты — это рекомендации TikTok для данного профиля. Отфильтруйте их по followers_count и is_verified, чтобы оставить тех, кто подходит под ваши требования.

TikTok не публикует свои критерии, и в ответе нет показателя сходства. Аккаунты приходят в том порядке, в котором их отдает TikTok, поэтому позиция в списке — единственный признак близости.

Нет, входные данные — только username и results_limit. Фильтруйте возвращенные строки по followers_count сами, а страны отобранных авторов проверяйте через TikTok Audience Demographics.

До 300, по умолчанию 30. Вы платите 0,5 кредита за каждый фактически возвращенный аккаунт, поэтому более короткий список стоит меньше заданного лимита.

Нет, поля email нет. Вы получаете описание профиля в text и сайт, если он указан в профиле.