tiktok/
profiles

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

TikTok Profiles API

Записи об авторах
Сопоставление аккаунтов
Снимки профилей
0,6 кредита за результат
Готово
Готово

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

README

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

TikTok Profiles

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

Возможности TikTok Profiles API

  • Пакетный поиск по именам пользователейНаходите один или несколько публичных профилей авторов по именам пользователей в одном запросе.
  • Нормализация входных именЗначения вида nasa и @nasa нормализуются перед сбором профилей.
  • Стабильная идентификация профиляСтройте индекс аккаунтов по ID аккаунта, имени пользователя, отображаемому имени и URL профиля.
  • Поля профиля и аудиторииВозвращает в одной записи описание профиля, аватар, статус верификации и приватности, а также число подписчиков, подписок, видео и общее число лайков.
  • Отслеживаемые снимки профилейКаждое обогащение и повторный снимок можно отследить по отправленному входному значению и collected_at.

Параметры TikTok Profiles API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный список публичных имен пользователей TikTok. Каждое значение может начинаться с @ или нет.

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

Начните со списка имен пользователей авторов и получите записи, готовые для каталога или CRM.

  1. Нормализуйте записи в списке авторов, например nasa и @nasa, и удалите дубли.
  2. Отправьте массив usernames методом POST на /v1/tiktok/profiles и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}. queued и running — обычные промежуточные статусы.
  4. После успешного завершения читайте 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 аккаунта, чтобы получить более полную картину об авторе.

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

TikTok Profiles API — FAQ

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

Укажите публичные имена пользователей в массиве usernames. Принимаются оба формата: exampleuser и @exampleuser.

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

Результаты содержат ID аккаунта, имя пользователя, отображаемое имя, URL профиля, публичное описание и аватар, а также поля статуса аккаунта, времени создания и региона, если они есть.

Результаты содержат публично видимое число подписчиков, подписок, видео и общее число лайков, зафиксированные во время сбора.

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

Используйте ID аккаунта и нормализованное имя пользователя, чтобы объединять поля авторов из Videos, Search и Hashtags с полями авторов из Comments.

Каждый возвращенный нормализованный профиль стоит 0,6 кредита.