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 задачи, затем сверьте нормализованные записи расшифровок с запрошенными источниками.
- Подготовьте один или несколько доступных URL публичных видео TikTok и при необходимости двухбуквенный код языка, например en.
- Отправьте urls и необязательный language методом POST на /v1/tiktok/video-transcript и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed; успешная задача всё равно может содержать меньше записей, чем было отправлено URL.
- Читайте 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 не содержит время публикации видео.
Связанные API
Помимо 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 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