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 с курсорной пагинацией.
- Подготовьте один или несколько известных ID аудио Instagram в виде непустых числовых строк.
- Отправьте audio_ids с необязательным results_limit на каждое аудио методом POST на /v1/instagram/audio-reels.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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 страниц, а не является полным историческим архивом.
Связанные API
Помимо 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 Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Highlight Items 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