tiktok/
user-videos

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

TikTok User Videos API

Ленты известных аккаунтов
Пакет имен пользователей
Контекст исходного аккаунта
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok User Videos

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

Возможности TikTok User Videos API

  • Ленты профилей известных аккаунтовПринимает одно или несколько имен пользователей TikTok и обходит публичную ленту видео каждого аккаунта независимо, ограничивая результаты выбранными аккаунтами, а не поиском по ключевым словам или хештегам.
  • Данные о видео и автореВозвращает ID и URL видео, подписи, язык, данные об авторе, ссылки на медиафайлы, длительность, хештеги, упоминания, музыку и публичные признаки контента.
  • Сигналы вовлеченности с метками времениСвязывает видимые счетчики просмотров, лайков, комментариев, репостов, сохранений и повторных публикаций со временем публикации и сбора, формируя записи о видео аккаунта на определенный момент.
  • Управляемый обход по каждому аккаунтуПрименяет сортировку latest или popular и необязательный регион к каждому имени пользователя, убирает дубли ID видео и соблюдает заданный лимит на аккаунт.

Параметры TikTok User Videos API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный список из одного или нескольких публичных имен пользователей TikTok; каждое значение может начинаться с @ или без него.
results_limitНеобязательныйМаксимальное число видео для каждого имени пользователя; по умолчанию 100, допускаются целые числа от 20 до 2 000.
sort_byНеобязательныйНеобязательная сортировка ленты профиля: по умолчанию latest, или popular для результатов в порядке ранжирования источника.
regionНеобязательныйНеобязательный двухбуквенный код региона, передается в верхнем регистре и может влиять на доступность контента в источнике.

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

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

  1. Подготовьте одно или несколько публичных имен пользователей TikTok и выберите сортировку latest или popular, необязательный двухбуквенный регион и results_limit на каждое имя пользователя.
  2. Отправьте usernames и необязательные параметры методом POST на /v1/tiktok/user-videos и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

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

  • Каталоги видео авторов: Индексируйте выбранные аккаунты по ID видео, каноническому URL, подписи, медиафайлам, времени публикации и extra.input_username, чтобы вести отслеживаемый каталог публичного контента.
  • Сравнение публикаций и вовлеченности: Сопоставляйте created_at с видимыми просмотрами, лайками, комментариями, репостами, сохранениями и повторными публикациями у известных аккаунтов, сохраняя collected_at как время снимка.
  • Исследование креативных форматов: Используйте подписи, язык, длительность, хештеги, упоминания, музыку, тип медиа и публичные признаки контента, чтобы сравнивать повторяющиеся креативные паттерны в выбранных лентах профилей.

Практические советы по TikTok User Videos API

  • Приводите каждое имя к одному виду и убирайте дубли перед отправкой: creator и @creator указывают на один аккаунт, но иначе могут обрабатываться отдельно.
  • Выбирайте results_limit с учетом числа имен пользователей, потому что лимит и предварительная оценка кредитов применяются к каждому переданному аккаунту независимо.
  • Используйте latest для сбора свежих видео, а popular считайте порядком источника, а не оценкой, рассчитанной SocQ.
  • Используйте region только для управления доступностью и не считайте его доказательством того, что возвращенное видео снято в этом регионе.
  • При объединении повторных задач убирайте дубли по id видео, сохраняя extra.input_username и collected_at для привязки к аккаунту и времени снимка.
  • Обрабатывайте необязательные поля автора, вовлеченности, медиа, музыки и признаков контента как поля, которые могут быть null, экранируйте публичные подписи перед выводом и не считайте URL медиафайлов источника постоянными.

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

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Comments API — Собирайте публичные комментарии верхнего уровня, авторов, вовлеченность, упоминания и признаки взаимодействия с автором видео.
  • TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
  • TikTok Trending Feed API — Собирайте текущую публичную ленту видео для региона: автор, подпись, обложка, метка времени и видимая вовлеченность.
  • TikTok Video Transcript API — Извлекайте доступный текст расшифровки, язык, формат и контекст источника по URL публичных видео.
  • TikTok Song API — Получайте публичные метаданные звука по ID клипа или URL музыки.

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

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

TikTok User Videos API — FAQ

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

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

results_limit — это максимум на каждое имя пользователя от 20 до 2 000, по умолчанию 100. Лента каждого профиля обходится независимо и может закончиться раньше, чем будет достигнут этот максимум.

latest — сортировка ленты профиля по умолчанию, а popular запрашивает результаты в порядке ранжирования источника. popular не является оценкой, рассчитанной SocQ, поэтому при сравнении результатов задач фиксируйте выбранную сортировку.

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

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

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

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