instagram/
audio-reels

Собирайте публичные ролики Reels Instagram по известным числовым ID аудио: подписи, данные автора, медиафайлы, видимая вовлеченность, метки времени и контекст исходного аудио.

Instagram Audio Reels API

Поиск по ID аудио
Публичные записи Reels
Лимиты на каждое аудио
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Audio Reels

Ролики Reels с аудио в Instagram — это публичные короткие видео, связанные с общим идентификатором аудио, с подписями, данными автора, ссылками на медиафайлы, метками времени и видимой вовлеченностью. Записи с привязкой к источнику помогают анализировать участие в трендах, исследовать креативы и сравнивать публичную активность Reels для разных ID аудио.

Возможности Instagram Audio Reels API

  • Выборка по известным ID аудиоОтправляйте один или несколько числовых ID аудио Instagram, чтобы собрать публичные Reels, связанные именно с этими идентификаторами, без поиска по названию или исполнителю.
  • Независимый сбор по каждому аудиоКаждый ID аудио обрабатывается с собственным results_limit, своей последовательностью курсоров и удалением дублей внутри входного значения, поэтому сбор по каждому источнику ограничен.
  • Записи Reels с привязкой к источникуПолучайте нормализованные ID и URL роликов Reels, подписи, данные автора, медиафайлы, метки времени, видимую вовлеченность и происхождение в extra.audio_id.

Параметры Instagram Audio Reels API

ПараметрыОбязательныйОписание
audio_idsОбязательныйОдин или несколько известных ID аудио Instagram в виде непустых числовых строк, разделенных запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число записей, запрашиваемых для каждого ID аудио; по умолчанию 100, принимаются целые числа от 20 до 2 000.

Как использовать Instagram Audio Reels API

Отправьте известные ID аудио как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные записи Reels с курсорной пагинацией.

  1. Подготовьте один или несколько известных ID аудио Instagram в виде непустых числовых строк.
  2. Отправьте audio_ids с необязательным results_limit на каждое аудио методом POST на /v1/instagram/audio-reels.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/audio-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_ids":["123456789012345"],"results_limit":20}'

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

Сценарии использования Instagram Audio Reels API

  • Анализ использования аудио: Группируйте публичные URL роликов Reels, подписи, авторов и метки времени по extra.audio_id, чтобы оценить видимое участие вокруг известного аудио.
  • Подбор креативных примеров: Формируйте набор для анализа с привязкой к источнику из подписей, данных авторов, ссылок на медиафайлы и исходных URL роликов Reels, связанных с выбранными ID аудио.
  • Сравнение видимой вовлеченности: Сравнивайте доступные лайки, комментарии, просмотры и воспроизведения собранных роликов Reels, сохраняя ID аудио, по которому получена каждая запись.

Практические советы по Instagram Audio Reels API

  • Определите и проверьте ID аудио до отправки: этот эндпоинт принимает числовые идентификаторы и не ищет аудио по названию песни, исполнителю или ключевому слову.
  • Планируйте объем и ожидаемые кредиты на каждый ID аудио: results_limit применяется к каждому отправленному идентификатору отдельно.
  • При объединении повторных сборов удаляйте дубли по стабильному ID ролика Reels или каноническому URL, сохраняя extra.audio_id для указания источника.
  • Считайте счетчики, медиафайлы, поля автора и метки времени необязательными и учитывайте, что сбор ограничен лимитом на аудио, концом ленты или потолком в 100 страниц, а не является полным историческим архивом.

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

  • Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
  • Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
  • Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
  • Instagram Tagged Posts API — Собирайте публичные публикации с отметкой выбранных профилей: авторы, медиа, упоминания, контекст отмеченного пользователя и вовлеченность.
  • Instagram Transcript API — Извлекайте текст расшифровки, язык, формат, URL источника и shortcode по URL публичных публикаций или Reels.
  • Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.

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

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

Instagram Audio Reels API — FAQ

Instagram Audio Reels API — это программный интерфейс для сбора публичных роликов Reels Instagram, связанных с отправленными числовыми ID аудио. Он возвращает нормализованные идентификаторы роликов, подписи, данные авторов, медиафайлы, метки времени, видимую вовлеченность и контекст исходного аудио.

Передайте непустой массив числовых строк — известных ID аудио Instagram. Эндпоинт не преобразует названия песен, имена исполнителей или ключевые слова в ID.

results_limit принимает целые числа от 20 до 2 000, по умолчанию 100. Он применяется к каждому ID аудио отдельно, а сбор по каждому источнику также останавливается в конце ленты или на потолке в 100 страниц.

Запись может включать ID ролика, URL, текст подписи, ID автора, имя пользователя, имя, аватар, ссылки на медиафайлы, created_at, collected_at, видимые счетчики лайков, комментариев, просмотров и воспроизведений, а также extra.audio_id.

Нет. Результаты ограничены запрошенным числом на аудио, публичной лентой, которую возвращает источник, и потолком сбора в 100 страниц; недоступные публичные поля также могут оставаться null или отсутствовать.

Тариф — 0,5 кредита за каждую возвращенную нормализованную запись без базовой платы. Оценка рассчитывается как results_limit на аудио, умноженный на число отправленных ID аудио, а итоговое списание считается по фактически сохраненным записям.