tiktok/
search-users

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

TikTok Search Users API

Поиск авторов
Нормализованные профили
Подбор авторов
0,6 кредита за результат
Готово
Готово

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

README

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

TikTok Search Users

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

Возможности TikTok Search Users API

  • Поиск аккаунтов по ключевым словамОтправьте любую строку запроса, чтобы найти публичные аккаунты TikTok, хендлы авторов и подходящие профили сообществ.
  • Нормализованные профили авторовПолучайте структурированные записи с именем пользователя, отображаемым именем, аватаром, текстом описания и отметкой верифицированного аккаунта.
  • Метрики аудиторииИзвлекайте видимое число подписчиков, подписок и общее число опубликованных видео, привязанные ко времени сбора.
  • Настраиваемый лимит результатовУправляйте размером выборки — до 2 000 авторов — с автоматической внутренней курсорной пагинацией.

Параметры TikTok Search Users API

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово или имя для поиска подходящих публичных аккаунтов авторов TikTok.
results_limitНеобязательныйМаксимальное число возвращаемых профилей авторов; по умолчанию 100, диапазон — от 1 до 2 000.

Как использовать TikTok Search Users API

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

  1. Выберите ключевое слово для query и необязательный results_limit до 2 000.
  2. Отправьте POST-запрос на /v1/tiktok/search-users со своим API-ключом SocQ.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Получите нормализованные элементы профилей из data.results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"taylor swift","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

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

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

Практические советы по TikTok Search Users API

  • Используйте конкретные нишевые ключевые слова или фрагменты хендлов, чтобы эффективно сузить результаты поиска.
  • При больших значениях results_limit пагинация автоматически проходит по нескольким страницам источника.
  • Проверяйте логическое поле is_verified, чтобы отличать подтвержденные аккаунты знаменитостей от фан-страниц.
  • Для лучших совпадений запускайте затем TikTok User Videos, чтобы проанализировать эффективность недавнего контента.

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

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok Followers List API — Собирайте нормализованные профили из публичных списков подписчиков с сохраненным контекстом источника и поддерживаемыми метриками.
  • TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
  • TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.

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

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

TikTok Search Users API — FAQ

TikTok Search Users API позволяет находить публичные аккаунты и профили авторов в TikTok по ключевым словам. Он возвращает нормализованные имена пользователей, отображаемые имена, число подписчиков и признаки верификации аккаунтов без аутентификации через пользовательскую сессию.

Нет. Все запросы аутентифицируются вашим API-ключом SocQ, официальный аккаунт разработчика TikTok или пользовательский OAuth не требуются.

Эндпоинт TikTok Search возвращает публичные видео, соответствующие запросу, а TikTok Search Users находит именно аккаунты авторов и профили каналов.