TikTok Videos
TikTok Videos — это короткие публикации с подписями, контекстом автора, медиафайлами, музыкой, длительностью, хештегами, упоминаниями, сведениями о публикации и видимой вовлеченностью. Эти сигналы контента помогают исследовать тренды, анализировать креативы, разбирать рекламные кампании и сравнивать эффективность.
Возможности TikTok Videos API
- Пакетная обработка URL видеоПревращает пакет ссылок на видео TikTok в единообразные записи о контенте.
- Стабильная идентификация видеоОпределяет видео и его источник по ID видео и каноническому URL.
- Поля контента и автораИзвлекает подпись, язык, время публикации, автора, длительность и данные обложки.
- Поля креативного контекстаДобавляет в анализ креативов хештеги, упоминания, музыку и признаки контента.
- Метрики на момент сбораСвязывает видимые счетчики вовлеченности с collected_at для снимков эффективности.
Параметры TikTok Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список прямых URL видео TikTok, которые сейчас публично доступны. |
Как использовать TikTok Videos API
Превращайте ссылки из закладок, отчетов или внутренних систем в готовый к анализу каталог видео.
- Соберите прямые ссылки на видео, приведите URL к единому формату и уберите дубли.
- Отправьте массив urls методом POST на /v1/tiktok/videos и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования TikTok Videos API
- Анализ контентных паттернов: Объединяйте подписи, хештеги, упоминания, музыку и длительность, чтобы сравнивать повторяющиеся элементы в выбранных видео.
- Отчеты по видео кампаний: Фиксируйте просмотры и вовлеченность для выбранного набора материалов и единообразно сравнивайте эффективность кампаний.
- Каталоги видеоматериалов: Индексируйте контент по ID видео, каноническому URL, обложке, автору и времени публикации для быстрого поиска.
- Разметка тем и форматов: Используйте язык, подписи, хештеги и музыку, чтобы классифицировать темы, форматы и целевые аудитории.
Практические советы по TikTok Videos API
- Объединяйте дубли материалов по id и сохраняйте url для проверки и перехода к источнику.
- Храните published_at как время выхода, а collected_at — как время снимка метрик.
- Объединяйте подпись, хештеги, упоминания и музыку в признаки контента, по которым можно искать.
- Если views присутствует и больше нуля, используйте его как знаменатель для коэффициентов лайков, комментариев и репостов.
- Связывайте записи Comments с тем же ID видео, чтобы сравнивать эффективность материала с реакцией аудитории.
- Собирайте набор для сравнения в близкие моменты времени, чтобы снимки вовлеченности оставались сопоставимыми.
Связанные API
Помимо TikTok Videos API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
- TikTok Comments API — Собирайте публичные комментарии верхнего уровня, авторов, вовлеченность, упоминания и признаки взаимодействия с автором видео.
- TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
- TikTok Trending Feed API — Собирайте текущую публичную ленту видео для региона: автор, подпись, обложка, метка времени и видимая вовлеченность.
- TikTok Video Transcript API — Извлекайте доступный текст расшифровки, язык, формат и контекст источника по URL публичных видео.
- TikTok Fake Views Checker API — Проверяйте видео по 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 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 Comment Keywords API