API Instagram Reels с музыкальным треком

POST

Состояние 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 время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

#
ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаinstagramИдентификатор платформы, фиксированное значение.
actionbodystringДаaudio_postsИдентификатор возможности, фиксированное значение.
audio_idbody.paramsstringДа-Музыка для audio_posts: audio_id из music публикации или ролика Reels либо ссылка на страницу аудио, например https://www.instagram.com/reels/audio/<number>/. Возвращает Reels с этой музыкой. Передавайте ID строкой. Значение, которое не удаётся распознать, отклоняется до какого-либо списания.
page_tokenbody.paramsstringНет-Токен страницы для 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, если этот запуск не может идти глубже; в этом случае данные могли остаться.

Примеры кода

#
bash
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; скопированный код никогда не содержит ваш ключ.

Пример ответа

#
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
json
{  "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_idShortcode публикации: часть ссылки после /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_urlURL видеофайла: полный 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_estimatedtrue означает, что 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_urlURL аватара автора; подписанная ссылка с ограниченным сроком действия.
posted_at_estimatedtrue означает, что страница не указала время публикации и 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 (пусто)
Нет данных. Без списания.

Ошибки

Google Analytics: нужно согласие Приватность