API Instagram Recommended Reels
Состояние 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 время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
#| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | instagram | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | recommended_reels | Идентификатор возможности, фиксированное значение. |
page_token | body.params | string | Нет | - | 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. |
Примеры кода
#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; скопированный код никогда не содержит ваш ключ.
Пример ответа
#{ "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_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. |
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); каждое поле присутствует, только если доступно. Отсутствует, если у публикации нет места. |
Ошибки и оплата
#- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.