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
Отправьте публичные исходные хендлы, а затем читайте нормализованные записи профилей из подписок в завершенной асинхронной задаче.
- Подготовьте одно или несколько публичных имен пользователей TikTok, с начальным @ или без него, и выберите results_limit от 20 до 2 000 для каждого имени.
- Отправьте usernames и results_limit методом POST на /v1/tiktok/following-list и сохраните возвращенный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying, и остановитесь, когда она завершится успешно или с ошибкой.
- После успешного завершения читайте 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, чтобы отслеживать исходный аккаунт.
- Считайте пустые или короткие результаты следствием публичной видимости и перед повторной попыткой проверяйте приватность аккаунта и доступность списка.
- Не трактуйте порядок результатов как новизну или силу связи, если ваши дальнейшие данные явно не содержат такого сигнала.
Связанные API
Помимо 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 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