TikTok Profiles
Профили TikTok — это публичные страницы авторов или аккаунтов с данными об идентификации, описаниями, аватарами, статусом верификации и приватности и видимым общим числом подписчиков, подписок, видео и лайков. Эти данные профилей помогают находить авторов, сравнивать аудитории, исследовать возможности партнерства и обогащать каталоги.
Возможности TikTok Profiles API
- Пакетный поиск по именам пользователейНаходите один или несколько публичных профилей авторов по именам пользователей в одном запросе.
- Нормализация входных именЗначения вида nasa и @nasa нормализуются перед сбором профилей.
- Стабильная идентификация профиляСтройте индекс аккаунтов по ID аккаунта, имени пользователя, отображаемому имени и URL профиля.
- Поля профиля и аудиторииВозвращает в одной записи описание профиля, аватар, статус верификации и приватности, а также число подписчиков, подписок, видео и общее число лайков.
- Отслеживаемые снимки профилейКаждое обогащение и повторный снимок можно отследить по отправленному входному значению и collected_at.
Параметры TikTok Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный список публичных имен пользователей TikTok. Каждое значение может начинаться с @ или нет. |
Как использовать TikTok Profiles API
Начните со списка имен пользователей авторов и получите записи, готовые для каталога или CRM.
- Нормализуйте записи в списке авторов, например nasa и @nasa, и удалите дубли.
- Отправьте массив usernames методом POST на /v1/tiktok/profiles и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}. queued и running — обычные промежуточные статусы.
- После успешного завершения читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@tiktok"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования TikTok Profiles API
- Обогащение каталога авторов: Превращайте списки имен пользователей в карточки авторов с ID аккаунтов, аватарами, описаниями, статусом и показателями масштаба.
- Подготовка к партнерству: Перед тем как связываться с авторами, изучайте их данные, объем публикаций и масштаб аудитории.
- Отслеживание роста авторов: Сохраняйте регулярные снимки числа подписчиков, видео и общего числа лайков для постоянной группы авторов.
- Сопоставление аккаунтов между датасетами: Используйте ID аккаунтов, чтобы связывать записи об авторах с соответствующими видео и комментариями.
Практические советы по TikTok Profiles API
- Используйте id как ключ автора, а username — для поиска и отображения.
- Сохраняйте отправленное входное значение, чтобы каждая полученная запись однозначно сопоставлялась с исходным списком авторов.
- Собирайте данные с фиксированной периодичностью и связывайте каждый снимок метрик с collected_at.
- Удаляйте дубли по имени пользователя после удаления начального @.
- Объединяйте avatar, display_name, biography и profile_url в удобные карточки авторов.
- Связывайте записи профилей, видео и комментариев по ID аккаунта, чтобы получить более полную картину об авторе.
Связанные API
Помимо TikTok Profiles API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Followers List 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