TikTok Followers List
Публично видимые списки подписчиков TikTok показывают идентификаторы аккаунтов, описания профилей, ссылки на профили и доступные счетчики аудитории или активности. Эти записи помогают формировать выборки аудитории, находить авторов, заполнять очереди обогащения и регулярно исследовать публичные списки.
Возможности TikTok Followers List API
- Сбор по нескольким аккаунтамСобирайте подписчиков для одного или нескольких публичных имен пользователей; results_limit применяется к каждому отправленному аккаунту отдельно.
- Ограниченный обход лентыВнутренне обходит поддерживаемые страницы подписчиков, пока не будет достигнут лимит на аккаунт, следующая страница не станет недоступной или не будет достигнут предел сбора.
- Нормализованные записи профилейВозвращает ID подписчика, имя пользователя, отображаемое имя, описание профиля, ссылку на аватар, URL профиля и поддерживаемые публичные метрики в единой структуре профиля.
- Сохранение контекста источникаСохраняет нормализованный отправленный хендл в extra.input_username для оставленной записи подписчика.
- Контроль дубликатов на уровне задачиОтсеивает повторяющиеся профили подписчиков в рамках задачи по нормализованному ID или URL профиля до сохранения результатов и пагинации.
Параметры TikTok Followers List API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный непустой список публичных имен пользователей TikTok. Значения могут начинаться с @ или нет; числовые ID аккаунтов, URL профилей и значения курсора не принимаются. |
results_limit | Необязательный | Необязательное целое число от 20 до 2 000, по умолчанию 100. Лимит применяется отдельно к каждому отправленному имени пользователя и задает верхнюю границу, а не гарантирует полноту. |
Как использовать TikTok Followers List API
Отправьте известные публичные хендлы, дождитесь завершения асинхронной задачи и постранично читайте сохраненные записи профилей.
- Удалите лишние пробелы, уберите необязательные начальные символы @ для собственной дедупликации и выберите публичные имена пользователей TikTok.
- Отправьте usernames и results_limit на каждое имя от 20 до 2 000 методом POST на /v1/tiktok/followers-list.
- Сохраните task_id и опрашивайте /v1/tasks/{task_id}; queued, running и retrying — обычные промежуточные статусы.
- После успешного завершения читайте data.results.items и передавайте next_cursor в тот же эндпоинт задачи, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/followers-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 follow next_cursor while has_more is trueСценарии использования TikTok Followers List API
- Выборки публичной аудитории: Формируйте ограниченную выборку публично видимых профилей подписчиков для качественного анализа аудитории.
- Очереди поиска авторов: Собирайте имена пользователей и ссылки на профили подписчиков, чтобы использовать их для ручной проверки или последующей задачи обогащения через TikTok Profiles.
- Регулярное исследование списков: Сохраняйте выборки с метками времени по одним и тем же публичным аккаунтам, чтобы отслеживать изменения в составе доступных профилей при каждом сборе.
- Данные для каталогов профилей: Превращайте записи публичных списков подписчиков в единообразные поля идентификации, описания, аватара и метрик для внутренних каталогов.
Практические советы по TikTok Followers List API
- Приводите регистр к единому виду и удаляйте начальный @ перед дедупликацией на своей стороне, иначе @name и name могут запустить равнозначные запросы к источнику.
- Считайте results_limit верхней границей на каждое имя пользователя: два имени при значении по умолчанию 100 дают оценку в 200 результатов, а не 100.
- Сохраняйте extra.input_username, но не используйте этот эндпоинт для точного анализа общих подписчиков: дедупликация на уровне задачи оставляет для каждого подписчика только один контекст источника.
- Передавайте в эндпоинты, принимающие имена пользователей TikTok, имя пользователя подписчика, а не числовой id.
- Не передавайте next_cursor в новом запросе на сбор: он только листает результаты, уже сохраненные для той же успешной задачи.
- Считайте, что metrics могут быть null, а created_at равен null, потому что строки подписчиков в источнике не всегда содержат эти поля.
- Ожидайте меньше записей для закрытых, ограниченных, недоступных или очень крупных аккаунтов и считайте ссылки на аватары URL источника, срок действия которых может истечь.
Связанные API
Помимо TikTok Followers List API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
- TikTok Following List API — Собирайте публичные профили, на которые подписаны аккаунты TikTok: нормализованные данные аккаунта, описания, видимые метрики и контекст исходного аккаунта.
- 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