tiktok/
video-transcript

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

TikTok Video Transcript API

Расшифровка видео
Необязательный язык
Plaintext или WebVTT
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Video Transcript

Записи TikTok Video Transcript содержат доступную речь или субтитры публичных видео вместе с языком, форматом plaintext или WebVTT, исходным URL, шорткодом и временем сбора. Эти записи помогают искать по устному контенту, анализировать ключевые слова и темы, проверять доступность контента и исследовать цитаты со ссылкой на источник.

Возможности TikTok Video Transcript API

  • Расшифровки по нескольким URLОбрабатывает один или несколько URL публичных видео TikTok в одной задаче и передает с каждым запросом необязательное предпочтение языка.
  • Нормализованный текст и происхождениеВозвращает текст расшифровки вместе с языком, форматом plaintext или WebVTT, исходным URL, ID записи, шорткодом и временем сбора в единой структуре.
  • Только доступные записиСоздает результат, только когда источник возвращает непустой текст расшифровки, поэтому в ответе видны именно доступные расшифровки без строк-заглушек.

Параметры TikTok Video Transcript API

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько доступных URL публичных видео TikTok, разделенных запятыми или переносами строк.
languageНеобязательныйНеобязательный предпочтительный язык расшифровки; используйте двухбуквенный код, например en, es или fr.

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

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

  1. Подготовьте один или несколько доступных URL публичных видео TikTok и при необходимости двухбуквенный код языка, например en.
  2. Отправьте urls и необязательный language методом POST на /v1/tiktok/video-transcript и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed; успешная задача всё равно может содержать меньше записей, чем было отправлено URL.
  4. Читайте data.results.items, сопоставляйте каждый url с входным набором и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Архивы устного контента с поиском: Индексируйте текст расшифровок вместе с исходными URL, языком, форматом, шорткодами и временем сбора, чтобы искать выбранные публичные видео по произнесенным словам.
  • Анализ ключевых слов и тем: Анализируйте нормализованный текст по известному набору видео, чтобы находить повторяющиеся слова, фразы и темы, сохраняя ссылку на источник для проверки.
  • Проверка доступности и цитат: Используйте доступный текст расшифровки и метаданные формата, чтобы готовить удобочитаемые копии или находить фрагменты, а затем сверяйте их со связанным публичным видео.

Практические советы по TikTok Video Transcript API

  • Перед отправкой проверьте, что каждая цель ведет на нужное публичное видео TikTok: запрос принимает любые непустые строки URL и не проверяет домен TikTok или путь /video/{id}.
  • Приводите URL к каноническому виду и удаляйте варианты с параметрами отслеживания перед формированием пакета, потому что обрезка пробелов и удаление дублей объединяют только полностью совпадающие строки.
  • Выбирая язык, используйте двухбуквенный код, например en, и направляйте дальнейшую обработку по возвращенному полю language, а не исходите из того, что предпочтение выполнено.
  • После успешного завершения сравнивайте возвращенные значения url с отправленным списком, чтобы недоступные, приватные, удаленные, ограниченные видео, а также видео без субтитров или без речи оставались видны в вашем рабочем процессе.
  • Выбирайте способ разбора по format, сохраняйте реплики WebVTT, если они есть, и используйте collected_at для отслеживания происхождения, потому что created_at не содержит время публикации видео.

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

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

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

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

TikTok Video Transcript API — FAQ

TikTok Video Transcript API — это программный интерфейс для извлечения доступного текста расшифровки из одного или нескольких URL публичных видео TikTok с необязательным предпочтением языка. Если доступен непустой текст расшифровки, он возвращает нормализованный текст, язык, формат plaintext или WebVTT, исходный URL, шорткод и время сбора.

Передайте непустой массив urls и при необходимости строку language. Эндпоинт не принимает results_limit, usernames, поисковые запросы, настройки загрузки медиафайлов и переключатель резервной обработки с помощью ИИ.

Каждая запись содержит id, platform, resource, type, url, text, language (может быть null), format, created_at, collected_at и extra.shortcode. В ней не сохраняются описания видео, авторы, метрики вовлеченности, обложки, URL для скачивания и объекты сегментов с таймкодами.

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

Нет. Укажите двухбуквенное предпочтение, например en, es или fr, а затем проверьте возвращенное поле language; доступность языка и точность расшифровки зависят от доступного источника.

Каждая возвращенная нормализованная запись расшифровки стоит 0,5 кредита без базовой платы. Входной URL, по которому не создано ни одной записи, по текущей политике пустых результатов не оплачивается.