instagram/
transcript

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

Instagram Transcript API

Расшифровки публикаций и Reels
Plaintext или WebVTT
Привязка к источнику
0,7 кредита за результат
Готово
Готово

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

README

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

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 задачи, затем читайте все нормализованные записи расшифровок с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных публикаций или роликов Reels в Instagram.
  2. Отправьте массив urls методом POST на /v1/instagram/transcript.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /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 в каждом полученном фрагменте.

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

Instagram Transcript API — FAQ

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

Передайте непустой массив urls с URL публичных публикаций или роликов Reels в Instagram. Эндпоинт не принимает имена пользователей, поисковые запросы или одиночное поле url.

Нет. Медиа без речи может не вернуть ни одной записи расшифровки, а публикация-карусель может дать несколько записей.

Нет. Этот эндпоинт принимает только urls; язык возвращается как метаданные записи, если источник его предоставляет.

format равен plaintext, если только возвращенная расшифровка не начинается с разметки WebVTT — тогда он равен webvtt. Записи также могут содержать text, language, ID, исходный URL, шорткод, created_at со значением null и collected_at.

Оплата составляет 0,7 кредита за каждую возвращенную запись расшифровки, базовой платы нет. Предварительная оценка исходит из числа переданных URL, а итоговый расход — из фактических записей, включая несколько записей из одной карусели.