tiktok/
following-list

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

TikTok Following List API

Связи по подпискам
Записи профилей
Лимиты на пользователя
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Following List

Списки подписок TikTok содержат публичные профили, на которые аккаунт открыто подписан, с ID пользователей, именами пользователей, отображаемыми именами, описаниями профилей, аватарами, ссылками на профили и видимыми метриками аккаунтов. Эти записи о связях и профилях помогают исследовать сети интересов, находить авторов, строить карты публичных связей и обогащать датасеты профилей.

Возможности TikTok Following List API

  • Связи исходного аккаунта с профилямиСобирайте записи профилей, на которые подписано каждое отправленное публичное имя пользователя, и сохраняйте исходный хендл в extra.input_username.
  • Нормализованные данные о профилях из подписокВозвращает стабильный ID пользователя, имя пользователя, отображаемое имя и канонический URL профиля TikTok для каждого сохраненного участника связи.
  • Контекст публичного профиляВключает текст описания профиля, ссылку на аватар и видимые метрики аккаунта, доступные для профиля из подписок.
  • Ограниченный сбор на каждого пользователяПрименяет results_limit отдельно к каждому имени пользователя, постранично обходит доступные данные списка и удаляет дубли сохраненных профилей по стабильному идентификатору.

Параметры TikTok Following List API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный список непустых публичных имен пользователей TikTok. Начальный @ допускается и удаляется перед сбором.
results_limitНеобязательныйМаксимальное число записей профилей из подписок, запрашиваемых для каждого имени пользователя. По умолчанию 100, допускаются целые числа от 20 до 2 000.

Как использовать TikTok Following List API

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

  1. Подготовьте одно или несколько публичных имен пользователей TikTok, с начальным @ или без него, и выберите results_limit от 20 до 2 000 для каждого имени.
  2. Отправьте usernames и results_limit методом POST на /v1/tiktok/following-list и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying, и остановитесь, когда она завершится успешно или с ошибкой.
  4. После успешного завершения читайте data.results.items; если has_more равно true, запросите ту же задачу с next_cursor, чтобы загрузить следующую страницу сохраненных результатов.
curl -X POST "https://api.socq.ai/v1/tiktok/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is true

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

  • Исследование сетей интересов: Используйте контекст исходного аккаунта вместе с ID, именами пользователей и описаниями профилей из подписок, чтобы изучать публичные интересы вокруг известного аккаунта.
  • Поиск авторов через исходные аккаунты: Просматривайте отображаемые имена, описания, аватары, ссылки на профили и видимые метрики, чтобы составить список кандидатов из публичных подписок аккаунта.
  • Обогащение датасета профилей: Добавляйте стабильные ID, канонические URL, публичные описания, аватары и видимые метрики аккаунтов к записям профилей, построенным по именам пользователей.

Практические советы по TikTok Following List API

  • Удаляйте начальный @ и дубли имен пользователей перед отправкой, чтобы равнозначные хендлы не запускали повторную обработку исходного аккаунта.
  • Задавайте results_limit для каждого имени пользователя по нужной глубине; большие входные списки могут дать до usernames × results_limit записей до учета окончания списков и удаления дубликатов.
  • Используйте id как основной ключ профиля, при его отсутствии — url, и сохраняйте extra.input_username, чтобы отслеживать исходный аккаунт.
  • Считайте пустые или короткие результаты следствием публичной видимости и перед повторной попыткой проверяйте приватность аккаунта и доступность списка.
  • Не трактуйте порядок результатов как новизну или силу связи, если ваши дальнейшие данные явно не содержат такого сигнала.

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

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

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

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

TikTok Following List API — FAQ

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

Отправьте один или несколько непустых хендлов в массиве usernames. Значения могут начинаться с @ или нет; начальный @ удаляется перед сбором.

Нормализованная запись может содержать ID пользователя из подписок, имя пользователя, отображаемое имя, канонический URL профиля, публичное описание, аватар, видимые метрики профиля, время сбора и extra.input_username.

По умолчанию results_limit равен 100, допускаются целые числа от 20 до 2 000, и лимит применяется к каждому имени пользователя отдельно. Сохраненный итог может быть меньше, если видимый список заканчивается или удаляются дубли профилей.

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

Нет. Считайте возвращенный порядок только порядком сбора, если отдельный источник явно не дает данных о близости или новизне связи.

Каждая сохраненная нормализованная запись профиля стоит 0,5 кредита. Оплата рассчитывается по фактическому числу сохраненных записей, поэтому за пустую задачу плата за результаты не взимается.