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
Отправьте поисковый запрос как асинхронную задачу, а затем получите нормализованные записи авторов, опрашивая задачу.
- Выберите ключевое слово для query и необязательный results_limit до 2 000.
- Отправьте POST-запрос на /v1/tiktok/search-users со своим API-ключом SocQ.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Получите нормализованные элементы профилей из 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, чтобы проанализировать эффективность недавнего контента.
Связанные API
Помимо 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 Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts 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 Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API