API Instagram Recommended Reels

POST

Состояние API

Состояние за 24 ч
Норма
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Последние 24 часа

Последние 30 дней

Read the Reels Instagram recommends on its Reels page, 10 per page; no input is needed. Each row has the same fields as a post result, except view_count. The list changes from call to call and is not a ranking.

Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение instagram, а в action — recommended_reels. Цена: $1.18 за 1 000 запросов ($0.001181 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

#
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Instagram Recommended Reels (instagram/recommended_reels).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: instagram и action: recommended_reels, а параметры передайте в params.
- Обязательных параметров нет.
- Необязательные параметры:
  - page_token: Page token for recommended_reels. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged.
- Возвращает список записей. Основные поля каждой записи: post_id (Shortcode публикации: часть ссылки посл…), url, text, media_type (Только два значения: video (видео), like_count, comment_count, author_username, author_name, posted_at, location, id, image_url; всего полей: 53, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Пример тела запроса:
{
  "platform": "instagram",
  "action": "recommended_reels",
  "params": {}
}
- Цена: $1.18 за 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Даrecommended_reelsИдентификатор возможности, фиксированное значение.
page_tokenbody.paramsstringНет-Page token for recommended_reels. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours and each page is one call; the last page has no next_page_token.

Примеры кода

#
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": "recommended_reels",
  "params": {}
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

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

#
Получено November 21, 2026 at 07:18 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
json
{  "id": "req_…",  "platform": "instagram",  "action": "recommended_reels",  "results": [    {      "post_id": "Df004fGz-Ig",      "url": "https://www.instagram.com/reel/Df004fGz-Ig/",      "text": "🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。\n\n蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。\n\n人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark!\n📍Odarijip 弘大…",      "media_type": "video",      "like_count": 1336,      "comment_count": 29,      "author_username": "y•••7",      "author_name": "i•••y",      "posted_at": "2026-11-17T02:15:30+00:00",      "location": "香港",      "id": "•••",      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/905867834_1120715444164288_8231478405717265133_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMjA4MDE0NjUxMjk5NDg0ODExMjA3MTU0Mzc0OTc2MjI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX…",      "video_url": "https://scontent-lax7-1.cdninstagram.com/o1/v/t2/f2/m86/AQOheRgHDZfLQyMWaSxdUyIfPMIkdGjWOxmBEWiGq1sPvcCfhiM2JzNNqor35cI_6Cd7akhRLuC0SR_nE2_jJ_feHKaTcTm5FI5Zjzo.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-lax7-1.cdninstagram.com&_nc_ohc=ICPFAqdR2-cQ7kNvwF8VIPn&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "hashtags": [        "弘大美食",        "Odarijip",        "오다리집"      ],      "product_type": "clips",      "share_count": 2638,      "repost_count": 112,      "duration_sec": 41,      "duration_estimated": true,      "video_url_expires_at": "2026-11-22T17:26:31+00:00",      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQMl_kNdQFW0sBrWxfCE0jgqZLDf0ANbBC-dBhKzbopXTuIx9QXzGk_HhiYguCsoxXwgUqV1LHUlBduGjeCQVQoiKbkhbUkVu09asjtl5lZvOQ.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=gLMVDeP-3aIQ7kNvwHLJFhE&efg=eyJ2Z…",      "video_hd_height": 1920,      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQNarz1QtNu3JmbGzJrpMQToCXzibhqIsaPuedSxVb1T-IwU4L8A9jkwFby54hwGbJS79qopnmwk-0T1BaGDwADX5R02AWZLleoO61Q.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=gUNRu21NicEQ7kNvwHWjx-X&efg=eyJ2ZW5jb2RlX…",      "video_hd_expires_at": "2026-11-25T15:21:26+00:00",      "is_paid_partnership": false,      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "music": {        "artist": "yuny1117",        "title": "Original audio",        "audio_id": "29040011078996048",        "is_original": true,        "is_trending": false,        "url": "https://www.instagram.com/reels/audio/29040011078996048/"      },      "platform": "instagram",      "location_detail": {        "id": "•••",        "name": "香港",        "url": "https://www.instagram.com/explore/locations/314055843/"      },      "duration_seconds": 41    },    {      "post_id": "DeQLC8vB-XV",      "url": "https://www.instagram.com/reel/DeQLC8vB-XV/",      "text": "Running Into the Last Light 🐎🌅✨\nDJi drone makes it possible \nA herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo…",      "media_type": "video",      "like_count": 511179,      "comment_count": 1086,      "author_username": "u•••n",      "author_name": "U•••n",      "posted_at": "2026-10-09T00:00:05+00:00",      "id": "•••",      "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/842492090_18635881834006763_6532142919362048035_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=NDAwMzc0ODY0OTg5NjUwMjc0MTI3MTQ0Nzg5MjIyOTg1MTc%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2Rl…",      "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM2_t64OHeUMHkiRrk_oXg1Fx13dHC8EsQn7qj4IoemJfIvUpgbG3jJW2XmbBs8bY50LXtPWvDOXmiZSLWZDp2wzEkz4BnWJxCfgVw.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=wZRSYNl-XEkQ7kNvwHmXjUk&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "hashtags": [        "HorseHerd",        "GrasslandLife",        "skypixel"      ],      "product_type": "clips",      "share_count": 60416,      "repost_count": 18769,      "duration_sec": 8,      "duration_estimated": true,      "video_url_expires_at": "2026-11-22T16:50:32+00:00",      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQPN-g2dLkgxeaSoGKlyRAv2pWmGWM1UkRFftBDUO0jdVuUhnHdK8QcM3DCbtKs8ZnhTj1cCRrKGDsWmGRa8V4tXDKhL55Yxk0zd4Dg.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=C84pV4KywUEQ7kNvwGt_uFU&efg=eyJ2ZW5jb2Rl…",      "video_hd_height": 1920,      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPDbrFss6LkseyEhe_bmqad9lEJ2BRsKkerSbbg58Yi-ojglE1qQF6hgNhDgLSOxrXDlWa3jQ9pVZZO7ri70bIitcJNpJAwkdyFhwg.mp4?_nc_cat=108&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=A1ZyzcC_ICQQ7kNvwEm4pbF&efg=eyJ2ZW5jb2RlX…",      "video_hd_expires_at": "2026-11-25T18:23:31+00:00",      "is_paid_partnership": false,      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-2.cdninstagram.com/•••",      "music": {        "artist": "usmanaryan",        "title": "Original audio",        "audio_id": "38684869254489915",        "is_original": true,        "is_trending": false,        "url": "https://www.instagram.com/reels/audio/38684869254489915/"      },      "platform": "instagram",      "duration_seconds": 8    }  ],  "next_page_token": …,  "pagination": { … },  "count": 10,  "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.
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); каждое поле присутствует, только если доступно. Отсутствует, если у публикации нет места.

Ошибки и оплата

#
401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

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