Instagram Transcript
Записи Instagram Transcript содержат текст, полученный из речи в публичных публикациях и роликах Reels, а также язык, формат вывода, исходный URL, шорткод и время сбора. Такие записи помогают искать по устному контенту, проверять доступность, индексировать контент и проводить исследования с привязкой к источнику.
Возможности Instagram Transcript API
- Несколько исходных URLОтправьте один или несколько URL публичных публикаций или роликов Reels в Instagram и получите расшифровки для медиа, в которых есть речь.
- Учет каруселейОтдельные записи расшифровок сохраняются, если одна публикация-карусель дает расшифровки для нескольких медиа.
- Нормализованный текст и происхождениеВозвращает текст расшифровки с языком, форматом plaintext или WebVTT, исходным URL, идентификатором медиа, шорткодом и временем сбора.
Параметры Instagram Transcript API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Один или несколько URL публичных публикаций или роликов Reels в Instagram, разделенные запятыми или переводами строки. |
Как использовать Instagram Transcript API
Отправьте URL публичных медиа Instagram как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте все нормализованные записи расшифровок с курсорной пагинацией.
- Подготовьте один или несколько URL публичных публикаций или роликов Reels в Instagram.
- Отправьте массив urls методом POST на /v1/instagram/transcript.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50, сопоставляйте ноль или несколько записей с каждым входным URL и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Instagram Transcript API
- Поиск по устному контенту: Индексируйте текст расшифровок вместе с языком, исходными URL и шорткодами, чтобы искать выбранные публичные публикации и ролики Reels по произнесенным словам.
- Исследование публикаций и Reels: Изучайте текст расшифровок по подобранному набору URL, сохраняя идентификаторы медиа и время сбора для проверки источников.
- Проверка субтитров и доступности: Используйте возвращенный текст и метаданные формата, чтобы готовить удобочитаемые версии или проверять, есть ли у выбранных публичных медиа пригодные записи устного контента.
Практические советы по Instagram Transcript API
- Передавайте канонические URL публичных публикаций или роликов Reels и убирайте точные дубли перед запуском задачи, чтобы каждый нужный источник обрабатывался один раз.
- Сопоставляйте результаты по ID записи, а не только по URL: медиа без речи может не дать записи, а один URL карусели может дать несколько.
- Ветвите дальнейший разбор по format: сохраняйте метки WebVTT, когда важна временная структура, а plaintext обрабатывайте как несегментированный текст.
- Используйте collected_at для истории сбора, потому что created_at не заполняется временем публикации медиа в Instagram.
- При разбиении текста расшифровки на части сохраняйте ID записи, исходный URL, шорткод, язык, формат и collected_at в каждом полученном фрагменте.
Связанные API
Помимо Instagram Transcript API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
- Instagram Tagged Posts API — Собирайте публичные публикации с отметкой выбранных профилей: авторы, медиа, упоминания, контекст отмеченного пользователя и вовлеченность.
- Instagram Audio Reels API — Собирайте публичные Reels по известному числовому ID аудио: подписи, авторы, медиа, метки времени, видимая вовлеченность и контекст исходного аудио.
- Instagram Highlight Items API — Получайте сохраненные публичные истории по известным ID актуального: текст, данные автора, медиа, метки времени, видимые метрики и контекст источника.
- Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API