Twitter Video Transcript
Видео в X (бывший Twitter) содержат в звуковой дорожке интервью, анонсы, демонстрации продуктов и комментарии, а расшифровка превращает эту речь в простой текст вместе с длительностью ролика в секундах. Записанную речь можно точно цитировать, кратко пересказывать, переводить и искать по ней теми же методами анализа ключевых слов и тем, что применяются к текстовым постам.
Возможности Twitter Video Transcript API
- Посты с видео по URLПередайте одну или несколько ссылок вида x.com/{username}/status/{post_id} на твиты с видео, и каждое видео вернет одну строку с id и url своего поста.
- Речь сплошным простым текстомtext содержит произнесенные в видео слова одним блоком простого текста, format равно «text», а язык расшифровки совпадает с языком говорящего.
- Длительность видео вместе с расшифровкойduration_seconds показывает продолжительность видео — это удобно для сортировки роликов по длине и для оценки того, насколько плотно в видео звучит речь.
Параметры Twitter Video Transcript API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Один или несколько URL постов X вида /{username}/status/{post_id}, каждый из которых указывает на пост с видео. |
Как использовать Twitter Video Transcript API
Отправьте URL постов с видео и получите по одной расшифровке на каждое видео.
- Отправьте {"urls": ["https://x.com/NASA/status/2119833829389041896"]} методом POST на /v1/x/post-transcript.
- Опрашивайте GET /v1/tasks/{task_id}; расшифровки готовы, когда status становится succeeded.
- Читайте каждую расшифровку из results.items, а если has_more равно true, получайте остальное с помощью results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'
# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.Сценарии использования Twitter Video Transcript API
- Цитирование сказанного в ролике: Копируйте точные фразы из text и указывайте url поста, чтобы цитату из интервью или пресс-ролика можно было сверить с источником.
- Краткий пересказ и перевод видеопостов: Передавайте text в модель суммаризации или перевода, чтобы превращать длинные видеопосты в короткие заметки или переводить их на другие языки.
- Поиск по речи во множестве видео: Индексируйте расшифровки видеопостов автора или бренда, чтобы находить все ролики, где упоминается продукт, человек или тема.
- Публикация текстовой версии видео: Размещайте text под видео в статьях, рассылках или справочных материалах, чтобы читатели могли следить за ним без звука.
Практические советы по Twitter Video Transcript API
- Закладывайте бюджет на длинные записи отдельно: видео длительностью до 2 минут стоит 0,7 кредита, а 10-минутная запись — 40 кредитов, поскольку оплачивается каждая начатая минута полной длительности.
- Определяйте язык text, прежде чем отправлять его на перевод: каждая расшифровка написана на языке, на котором говорят в видео.
- Если вы не уверены, в каких постах есть видео, отправляйте смешанные списки URL: посты с видео вернут расшифровки, остальные ничего не стоят, а список только из текстовых постов или постов с изображениями завершится ошибкой с полным возвратом кредитов.
Связанные API
Помимо Twitter Video Transcript API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
- Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
- X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
- X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
- Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
- Twitter Media Scraper API — Собирайте посты аккаунта с фото, видео и GIF вместе с медиафайлами в максимальном качестве.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API