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
Отправьте известные публичные имена пользователей как асинхронную задачу, затем читайте нормализованные видео с привязкой к аккаунтам с курсорной пагинацией результатов.
- Подготовьте одно или несколько публичных имен пользователей TikTok и выберите сортировку latest или popular, необязательный двухбуквенный регион и results_limit на каждое имя пользователя.
- Отправьте usernames и необязательные параметры методом POST на /v1/tiktok/user-videos и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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 медиафайлов источника постоянными.
Связанные API
Помимо 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 Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users 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