Instagram Recommended Reels API

Read a page of recommended Reels with no required parameter: text, like_count, comment_count, author_username and a signed video_url on each row, for $1.18 per 1,000 calls.

  • No required parameter
  • The content differs on each call
  • Failed calls and empty results are not charged

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "recommended_reels",
      "params": {}
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_username": "y•••7",
          "post_id": "Df004fGz-Ig",
          "text": "🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。\n\n蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。\n\n人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark!\n📍Odarijip 弘大…",
          "media_type": "video"
        },
        …
      ],
      "count": 10
    }
  3. 3Rows

    author_usernamepost_idtextmedia_type
    y•••7Df004fGz-Ig🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀 弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。 店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。 蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。 將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。 人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark! 📍Odarijip 弘大…video
    u•••nDeQLC8vB-XVRunning Into the Last Light 🐎🌅✨ DJi drone makes it possible A 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…video
  4. 4CSV

    instagram-recommended_reels-sample.csv post_id,url,text,media_type,like_count,comment_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

A request with no required parameter goes in. One response returns a page of recommended Reels, each row with text, like_count, video_url and more. These become table rows and a CSV file.

What data you get

The table shows rows from a real call, captured November 21, 2026 at 07:18 (UTC), that returned 10 rows. Gray bars mark removed personal information (••• in the CSV). The content differs on each call. Your own calls return these fields as listed in the field reference.

post_idurltextmedia_typelike_countcomment_countauthor_usernameauthor_nameposted_atlocationidimage_urlvideo_urlauthor_idwidthheightis_comments_disabledauthor_follower_counthashtagstop_commentsproduct_typeplay_countfb_play_countfb_like_countfb_comment_countshare_countrepost_countduration_secduration_secondsduration_estimatedimage_countvideo_countvideo_url_expires_atvideo_hd_urlvideo_hd_heightaudio_urlvideo_hd_expires_atis_paid_partnershipis_pinnedlikes_hiddencaption_is_editedaccessibility_captionauthor_is_verifiedauthor_is_privateauthor_avatar_urlposted_at_estimatedmentionstagged_userscoauthorssponsorsmediamusicplatformlocation_detail
Df004fGz-Ighttps://www.instagram.com/reel/Df004fGz-Ig/🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀 弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。 店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。 蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。 將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。 人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark! 📍Odarijip 弘大…video133629y•••7i•••y2026-11-17T02:15:30+00:00香港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…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…10801920falsenull["弘大美食","Odarijip","오다리집"]nullclipsnullnullnullnull26381124141truenullnull2026-11-22T17:26:31+00:00https://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…1920https://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…2026-11-25T15:21:26+00:00falsenullnullnullnulltruefalsenullnullnullnullnullnull{"artist":"yuny1117","title":"Original audio","audio_id":"29040011078996048","is_original":true,"is_trending":false,"url":"https://www.instagram.com/reels/audio/29040011078996048/"}instagram{"id":"•••","name":"香港","url":"https://www.instagram.com/explore/locations/314055843/"}
DeQLC8vB-XVhttps://www.instagram.com/reel/DeQLC8vB-XV/Running Into the Last Light 🐎🌅✨ DJi drone makes it possible A 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…video5111791086u•••nU•••n2026-10-09T00:00:05+00:00nullhttps://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…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…10801920falsenull["HorseHerd","GrasslandLife","skypixel"]nullclipsnullnullnullnull604161876988truenullnull2026-11-22T16:50:32+00:00https://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…1920https://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…2026-11-25T18:23:31+00:00falsenullnullnullnulltruefalsenullnullnullnullnullnull{"artist":"usmanaryan","title":"Original audio","audio_id":"38684869254489915","is_original":true,"is_trending":false,"url":"https://www.instagram.com/reels/audio/38684869254489915/"}instagramnull

Use cases

  • See what recommended Reels look like

    Read text, hashtags and music to see what the Reels are about and which music they use.

  • Find Reels with high engagement

    Use like_count and comment_count to pick the ones with high engagement.

  • Find the creators that get recommended

    Read author_username to list the accounts in the recommendations.

  • Take the video for offline analysis

    video_url is an mp4 with sound. It expires, so download it soon.

Instagram Graph API vs EveryInfra

Here is how the official Instagram Graph API and EveryInfra recommended_reels compare on account requirement and on access review.

ComparedInstagram Graph APIEveryInfra
Account requirement"To use the APIs, your app users must have an Instagram professional account"The request has no required parameter and needs only one EveryInfra API key. You and your users do not need an Instagram professional account.
Access review"Advanced Access is the access level required if your app serves Instagram professional accounts that you don’t own or manage" and "This access level requires App Review and Business Verification."You send one EveryInfra API key in the Authorization: Bearer header. You do not submit a Meta app review and do not log in to Instagram.

Quotes are from Meta's developer documentation, checked 2026-11-22. This table compares access conditions only. Official sources: Instagram Platform overview (updated 2026-10-29)

Limits and gotchas

  • There is no required parameter. Leave page_token out for the first page.
  • One call returns one page. If the response has next_page_token, send it back unchanged as page_token and keep the other parameters the same. The token is valid for 24 hours, and each page counts as one call. With no next_page_token, you cannot page further.
  • The result differs on each call. It is not a ranking.
  • The fields match a post row, but there is no view_count. For plays, pass the url of a row to post.
  • When Instagram cannot answer, the call returns 503 and is not charged.
  • video_url is signed and expires. Use video_url_expires_at when it is present.

Pricing

You pay $0.001181 per call, not per row. Each page counts as one call. Failed calls and empty results are not charged.

CallsCost
10,000$11.81
100,000$118.06
1,000,000$1,180.56

Totals use the list price per call.

Code samples

#
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 definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for recommended_reels, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Recommended Reels endpoint (instagram/recommended_reels).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to recommended_reels, and put the parameters inside params.
- No required parameters.
- Optional parameters:
  - 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.
- Returns a list of records. Main fields of each record: post_id (Post shortcode: the part of the link af…), url, text, media_type (Only two values: video (videos), like_count, comment_count, author_username, author_name, posted_at, location, id, image_url; 53 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
  "platform": "instagram",
  "action": "recommended_reels",
  "params": {}
}
- Price: $1.18 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYesrecommended_reelsCapability identifier, fixed value.
page_tokenbody.paramsstringNo-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.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
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": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
post_idPost shortcode: the part of the link after /p/ or /reel/ (not a numeric ID).
urlLink to the record on the platform.
textBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
media_typeOnly two values: video (videos; Reels are also video) and image (images; carousel posts are also recorded as image, and when product_type is present, a product_type of carousel_container marks a carousel).
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
author_usernameAuthor's username (@handle), usually usable in URLs.
author_nameAuthor's display name.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
locationLocation description passed through as is; the format varies by platform.
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
image_urlImage link. Capabilities with several images may return an image_urls array.
video_urlVideo file URL: the complete mp4 with sound, playable directly. For a carousel post with videos, it is the first video; absent when the post is not a video. The link is signed and expires; when video_url_expires_at is present, go by it.
author_idAuthor's unique ID on the platform.
widthWidth of the original image or video, in pixels.
heightHeight of the original image or video, in pixels.
is_comments_disabledWhether comments are turned off on the post.
author_follower_countAuthor's follower count. null means not disclosed.
hashtagsHashtags in the text, in order of appearance; absent when there are none.
top_commentsA few comments shown under the post; each entry has the text (text) and the commenter (author_username). Absent when there are none.
product_typeContent format as Instagram classifies it: feed (regular post), clips (Reels), carousel_container (carousel), longform (long video).
play_countPlay count.
fb_play_countPlay count on Facebook, when the author also published this post on Facebook; appears only on such posts.
fb_like_countLike count on Facebook, when the author also published this post on Facebook; appears only on such posts.
fb_comment_countComment count on Facebook, when the author also published this post on Facebook; appears only on such posts.
share_countShares. null means not disclosed, not 0.
repost_countReposts (as distinct from quote posts). null means not disclosed.
duration_secDuration, in seconds.
duration_secondsDuration in seconds. null for content that is not video or audio.
duration_estimatedtrue means duration_sec is a whole number of seconds read from the video link, at most 1 second off the exact duration. Appears only when the duration was read this way.
image_countNumber of images: 1 for a single-image post; for a carousel post, the number of images in it, videos not counted.
video_countNumber of videos in a carousel post; only carousel posts have it.
video_url_expires_atExpiry time of video_url, ISO 8601, UTC.
video_hd_urlHighest-quality video track: picture only, no sound. It expires; the time is in video_hd_expires_at. For video with sound, merge it with audio_url (for example, combine the two tracks with ffmpeg), or use video_url directly.
video_hd_heightPicture height of video_hd_url, in pixels.
audio_urlAudio track of the video, sound only; it expires at about the same time as video_hd_url (see video_hd_expires_at). Absent when the video has no separate audio track (for example, a silent video).
video_hd_expires_atExpiry time of video_hd_url, ISO 8601, UTC; audio_url expires at about the same time.
is_paid_partnershipWhether the post is marked "Paid partnership". Appears only when the page gives this information, and may be false.
is_pinnedWhether the item is pinned. Posts (user_posts, tagged_posts, recent_posts, and other actions that return posts, such as location_posts, audio_posts and explore): pinned by the author to the profile grid or the Reels tab; appears only when pinned, with the value true. Comments (comments): pinned by the post author; appears only when pinned, with the value true. Highlights (highlights): whether it is pinned first in the profile highlights bar.
likes_hiddenThe author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then.
caption_is_editedThe caption was edited. Appears only when edited, with the value true.
accessibility_captionImage description that Instagram generates automatically (alternative text, in English).
author_is_verifiedWhether the author's account has a verified badge. Appears in user_posts, tagged_posts, location_posts, audio_posts, explore, stories and comment_replies, and in post, discover, reels, hashtag and reels_search rows when it has a value.
author_is_privateWhether the author's account is private.
author_avatar_urlAuthor avatar URL; signed link that expires.
posted_at_estimatedtrue means the page gave no publish time and posted_at is the upload time worked out from the post's numeric ID (id); it usually equals the publish time, and is earlier than it for scheduled posts. Appears only when estimated (common in tagged_posts).
mentionsUsernames @-mentioned in the text, as an array.
tagged_usersUsernames of the people tagged in the images or videos, as an array; for a carousel post, tags on every item count.
coauthorsCoauthors: usernames of the accounts credited together with the author on this post, as an array.
sponsorsUsernames of the brand accounts named in the paid partnership, as an array.
mediaEach item in a carousel post, one entry per item: type (image or video), image_url (image URL, the cover image for a video; signed link that expires), video_url (videos only; mp4 with sound), width and height (pixels). Only carousel posts have it.
musicMusic used by the post or Reel, as an object: artist and title; some also carry audio_id (music ID), is_original (true for original audio recorded by the author, false for a song from the music library), is_explicit (whether a library song is marked explicit), is_trending (whether original audio is trending; original audio only) and url (the Instagram page for this music). For original audio, title is usually Original audio and artist is the username of its author. Absent when there is no music.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
location_detailDetails of the location attached to the post, as an object: id (location ID), name (location name, same as location), short_name, city, address, lat, lng, url (the Instagram page for this location); each appears only when available. Absent when the post has no location.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram recommended Reels API return?

Each row is one recommended Reel: post_id, url, text, media_type, like_count, comment_count, author_username, posted_at and video_url.

Is the result the same each time?

No. The content differs on each call and is not a ranking, so do not compare two results as the same list.

How do I get the plays of one Reel?

The rows have no view_count. Pass the url of a row to post to read its full data.

How much does one page cost?

It costs $0.001181 per call, or $1.18 per 1,000 calls. Each page counts as one call, not each row. Failed calls and empty results are not charged.

Do I need an Instagram login?

No. You send one EveryInfra API key in the Authorization: Bearer header. No Instagram login or access token is needed.

You can call the other Instagram endpoints with the same key, such as post to read the full data of one recommended Reel.

Google Analytics needs consent. Privacy