tiktok/
followers-list

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

TikTok Followers List API

Профили подписчиков
Выборка аудитории
Исследование публичных списков
0,5 кредита за результат
Готово
Готово

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

README

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

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

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

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

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

TikTok Followers List API — FAQ

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

Отправьте непустой массив usernames с публичными хендлами, при желании с префиксом @, и необязательный results_limit. Числовые ID целевых аккаунтов, URL профилей и курсоры сбора не принимаются.

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

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

Пагинация ленты TikTok выполняется внутри и не является параметром отправки. next_cursor, возвращаемый после успешного завершения, только загружает следующую страницу сохраненных результатов из /v1/tasks/{task_id}.

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

Каждый сохраненный нормализованный результат стоит 0,5 кредита, базовой платы нет. Первоначальная оценка умножает results_limit на число отправленных имен пользователей, а неиспользованные кредиты предоплаты возвращаются после завершения задачи.