tiktok/
videos

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

TikTok Videos API

Обогащение по URL
Анализ креативов
Снимки эффективности
0,7 кредита за результат
Готово
Готово

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

README

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

TikTok Videos

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

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

  • Пакетная обработка URL видеоПревращает пакет ссылок на видео TikTok в единообразные записи о контенте.
  • Стабильная идентификация видеоОпределяет видео и его источник по ID видео и каноническому URL.
  • Поля контента и автораИзвлекает подпись, язык, время публикации, автора, длительность и данные обложки.
  • Поля креативного контекстаДобавляет в анализ креативов хештеги, упоминания, музыку и признаки контента.
  • Метрики на момент сбораСвязывает видимые счетчики вовлеченности с collected_at для снимков эффективности.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список прямых URL видео TikTok, которые сейчас публично доступны.

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

Превращайте ссылки из закладок, отчетов или внутренних систем в готовый к анализу каталог видео.

  1. Соберите прямые ссылки на видео, приведите URL к единому формату и уберите дубли.
  2. Отправьте массив urls методом POST на /v1/tiktok/videos и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте 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 видео, чтобы сравнивать эффективность материала с реакцией аудитории.
  • Собирайте набор для сравнения в близкие моменты времени, чтобы снимки вовлеченности оставались сопоставимыми.

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

TikTok Videos API — FAQ

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

Поместите один или несколько прямых URL видео TikTok в массив urls. Каждый URL обрабатывается как запрос известного видео.

Да. urls принимает несколько прямых ссылок для пакетного обогащения списков видео кампаний, авторов или конкурентов.

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

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

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

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