API Instagram Reels с музыкальным треком
Состояние API
- Состояние за 24 ч
- Норма
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите список Reels в Instagram, в которых используется одна музыкальная композиция, по audio_id (audio_id из music поста или ссылка на страницу аудио). Каждая запись — ролик Reels с подписью, числом воспроизведений, лайками, комментариями, длительностью в секундах, автором, временем публикации и ссылкой на видео, а также audio_info с названием трека, исполнителем и числом Reels. Одна страница за вызов, до 12 роликов; limit ни на что не влияет. Для следующей страницы передайте next_page_token из предыдущего ответа как page_token; у последней страницы его нет. Ссылки на видео подписаны и истекают.
Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение instagram, а в action — audio_posts. Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
#Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Instagram Reels с музыкальным треком (instagram/audio_posts).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: instagram и action: audio_posts, а параметры передайте в params.
- Обязательные параметры:
- audio_id: Музыка для audio_posts: audio_id из music публикации или ролика Reels либо ссылка на страницу аудио, например https://www.instagram.com/reels/audio/<number>/. Возвращает Reels с этой музыкой. Передавайте ID строкой.
- Необязательные параметры:
- page_token: Токен страницы для user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts и explore. Для первой страницы не передавайте его.
- Возвращает список записей. Основные поля каждой записи: post_id (Shortcode публикации: часть ссылки посл…), url, text, media_type (Только два значения: video (видео), like_count, comment_count, view_count, author_username, author_name, posted_at, location, id; всего полей: 55, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Пример тела запроса:
{
"platform": "instagram",
"action": "audio_posts",
"params": {
"audio_id": "29431066483154650"
}
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
#| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | instagram | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | audio_posts | Идентификатор возможности, фиксированное значение. |
audio_id | body.params | string | Да | - | Музыка для audio_posts: audio_id из music публикации или ролика Reels либо ссылка на страницу аудио, например https://www.instagram.com/reels/audio/<number>/. Возвращает Reels с этой музыкой. Передавайте ID строкой. Значение, которое не удаётся распознать, отклоняется до какого-либо списания. |
page_token | body.params | string | Нет | - | Токен страницы для user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts и explore. Для первой страницы не передавайте его; дальше передавайте next_page_token в точности как получили, не меняя остальные параметры (кроме limit, если он есть). Каждая страница — один вызов; токены действуют 24 часа. Если next_page_token нет, страниц больше нет: pagination.stop_reason равен end_of_list в конце списка или depth_limit, если этот запуск не может идти глубже; в этом случае данные могли остаться. |
Примеры кода
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "audio_posts",
"params": {
"audio_id": "29431066483154650"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
#{ "id": "req_…", "platform": "instagram", "action": "audio_posts", "results": [ { "post_id": …, "url": …, "text": …, "media_type": …, "like_count": …, "comment_count": …, "view_count": …, "author_username": …, "author_name": …, "posted_at": …, "location": …, "id": …, "image_url": …, "video_url": …, "author_id": …, "width": …, "height": …, "is_comments_disabled": …, "author_follower_count": …, "hashtags": …, "top_comments": …, "product_type": …, "play_count": …, "fb_play_count": …, "fb_like_count": …, "fb_comment_count": …, "share_count": …, "repost_count": …, "duration_sec": …, "duration_seconds": …, "duration_estimated": …, "image_count": …, "video_count": …, "video_url_expires_at": …, "video_hd_url": …, "video_hd_height": …, "audio_url": …, "video_hd_expires_at": …, "is_paid_partnership": …, "is_pinned": …, "likes_hidden": …, "caption_is_edited": …, "accessibility_caption": …, "author_is_verified": …, "author_is_private": …, "author_avatar_url": …, "posted_at_estimated": …, "mentions": …, "tagged_users": …, "coauthors": …, "sponsors": …, "media": …, "music": …, "platform": …, "location_detail": …, "audio_info": … } ], "next_page_token": …, "pagination": { … }, "count": …, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Поля ответа
#Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
post_id | Shortcode публикации: часть ссылки после /p/ или /reel/ (не числовой ID). |
url | Ссылка на запись на платформе. |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
media_type | Только два значения: video (видео; Reels тоже video) и image (изображения; карусели тоже записываются как image, а если есть product_type, карусель обозначается значением product_type, равным carousel_container). |
like_count | Лайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0. |
comment_count | Комментарии. null означает, что значение не раскрыто, а не 0. |
view_count | Просмотры или воспроизведения. null означает, что значение не раскрыто, а не 0. |
author_username | Имя пользователя автора (@handle), обычно подходит для URL. |
author_name | Отображаемое имя автора. |
posted_at | Время публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает. |
location | Описание местоположения передаётся как есть; формат зависит от платформы. |
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
video_url | URL видеофайла: полный mp4 со звуком, воспроизводится напрямую. Для карусели с видео — первое видео; отсутствует, если публикация не является видео. Ссылка подписана и имеет ограниченный срок действия; если есть video_url_expires_at, ориентируйтесь на него. |
author_id | Уникальный ID автора на платформе. |
width | Ширина исходного изображения или видео в пикселях. |
height | Высота исходного изображения или видео в пикселях. |
is_comments_disabled | Отключены ли комментарии к публикации. |
author_follower_count | Число подписчиков автора. null означает, что значение не раскрыто. |
hashtags | Хештеги в тексте в порядке появления; поле отсутствует, если их нет. |
top_comments | Несколько комментариев, показанных под публикацией; каждый элемент содержит текст (text) и автора комментария (author_username). Отсутствует, если комментариев нет. |
product_type | Формат контента по классификации Instagram: feed (обычная публикация), clips (Reels), carousel_container (карусель), longform (длинное видео). |
play_count | Число воспроизведений. |
fb_play_count | Число воспроизведений в Facebook, если автор разместил эту публикацию и в Facebook; присутствует только у таких публикаций. |
fb_like_count | Число лайков в Facebook, если автор разместил эту публикацию и в Facebook; присутствует только у таких публикаций. |
fb_comment_count | Число комментариев в Facebook, если автор разместил эту публикацию и в Facebook; присутствует только у таких публикаций. |
share_count | Количество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0. |
repost_count | Репосты (без учёта цитирований). null означает, что значение не раскрыто. |
duration_sec | Длительность в секундах. |
duration_seconds | Длительность в секундах. null для контента, который не является видео или аудио. |
duration_estimated | true означает, что duration_sec — целое число секунд, считанное по ссылке на видео, и отличается от точной длительности не более чем на 1 секунду. Присутствует, только если длительность получена таким способом. |
image_count | Число изображений: 1 для публикации с одним изображением; для карусели — число изображений в ней без учёта видео. |
video_count | Число видео в карусели; есть только у каруселей. |
video_url_expires_at | Время истечения срока действия video_url, ISO 8601, UTC. |
video_hd_url | Видеодорожка наивысшего качества: только изображение, без звука. Срок действия ограничен; время указано в video_hd_expires_at. Для видео со звуком объедините её с audio_url (например, сведите две дорожки с помощью ffmpeg) или используйте video_url напрямую. |
video_hd_height | Высота изображения video_hd_url в пикселях. |
audio_url | Звуковая дорожка видео, только звук; срок её действия истекает примерно тогда же, когда у video_hd_url (см. video_hd_expires_at). Отсутствует, если у видео нет отдельной звуковой дорожки (например, у видео без звука). |
video_hd_expires_at | Время истечения срока действия video_hd_url, ISO 8601, UTC; срок действия audio_url истекает примерно тогда же. |
is_paid_partnership | Помечена ли публикация меткой «Оплачено спонсором» (Paid partnership). Присутствует, только если страница отдаёт эту информацию, и может быть false. |
is_pinned | Закреплён ли элемент. Публикации (user_posts, tagged_posts, recent_posts и другие действия, возвращающие публикации, например location_posts, audio_posts и explore): закреплены автором в сетке профиля или на вкладке Reels; поле присутствует, только если публикация закреплена, со значением true. Комментарии (comments): закреплены автором публикации; поле присутствует, только если комментарий закреплён, со значением true. «Актуальное» (highlights): закреплён ли раздел первым в панели «Актуальное» профиля. |
likes_hidden | Автор скрыл число лайков. Присутствует, только если число скрыто, со значением true; в этом случае like_count обычно отсутствует. |
caption_is_edited | Подпись была отредактирована. Присутствует, только если подпись редактировалась, со значением true. |
accessibility_caption | Описание изображения, автоматически создаваемое Instagram (альтернативный текст на английском). |
author_is_verified | Есть ли у аккаунта автора значок подтверждения. Присутствует в user_posts, tagged_posts, location_posts, audio_posts, explore, stories и comment_replies, а также в записях post, discover, reels, hashtag и reels_search, если у поля есть значение. |
author_is_private | Закрыт ли аккаунт автора. |
author_avatar_url | URL аватара автора; подписанная ссылка с ограниченным сроком действия. |
posted_at_estimated | true означает, что страница не указала время публикации и posted_at — время загрузки, вычисленное по числовому ID публикации (id); обычно оно совпадает со временем публикации, а у отложенных публикаций оно раньше. Присутствует, только если время оценено (часто в tagged_posts). |
mentions | Имена пользователей, упомянутых через @ в тексте, в виде массива. |
tagged_users | Имена пользователей, отмеченных на изображениях или в видео, в виде массива; для карусели учитываются отметки на всех элементах. |
coauthors | Соавторы: имена пользователей аккаунтов, указанных в этой публикации вместе с автором, в виде массива. |
sponsors | Имена пользователей аккаунтов брендов, указанных в метке платного партнёрства («Оплачено спонсором»), в виде массива. |
media | Каждый элемент карусели, по одной записи на элемент: type (image или video), image_url (URL изображения, для видео — обложка; подписанная ссылка с ограниченным сроком действия), video_url (только для видео; mp4 со звуком), width и height (пиксели). Есть только у каруселей. |
music | Музыка, использованная в публикации или Reels, в виде объекта: artist и title; у некоторых также есть audio_id (ID музыки), is_original (true для оригинального аудио, записанного автором, false для трека из музыкальной библиотеки), is_explicit (есть ли у трека из библиотеки метка explicit), is_trending (в трендах ли оригинальное аудио; только для оригинального аудио) и url (страница этой музыки в Instagram). Для оригинального аудио title обычно равен Original audio, а artist — имя пользователя его автора. Отсутствует, если музыки нет. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
location_detail | Сведения о месте, прикреплённом к публикации, в виде объекта: id (ID места), name (название места, совпадает с location), short_name, city, address, lat, lng, url (страница этого места в Instagram); каждое поле присутствует, только если доступно. Отсутствует, если у публикации нет места. |
audio_info | (audio_posts) Запрошенная музыка, одинаковая во всех записях, в виде объекта: audio_id, title, artist, reels_count (число Reels с этой музыкой) и url (страница этой музыки в Instagram); каждое поле присутствует, только если доступно. |
Ошибки и оплата
#- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.