# Instagram Recommended Reels API (instagram.recommended_reels)

- Canonical page: [https://everyinfra.com/en/instagram-api/recommended_reels](https://everyinfra.com/en/instagram-api/recommended_reels?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "recommended_reels", "params": {...}}
- Price: $0.001181 per call ($1.18 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of 10 per call (limit is ignored; pass the top-level next_page_token from the response as page_token for the next page)
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=recommended_reels

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| page_token | not declared | no | not declared | 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 fields (items in `results`)

| field | meaning |
|---|---|
| post_id | Post shortcode: the part of the link after /p/ or /reel/ (not a numeric ID). |
| url | Link to the record on the platform. |
| text | Body 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_type | Only 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_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| posted_at | Publish 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. |
| location | Location description passed through as is; the format varies by platform. |
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| video_url | Video 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_id | Author's unique ID on the platform. |
| width | Width of the original image or video, in pixels. |
| height | Height of the original image or video, in pixels. |
| is_comments_disabled | Whether comments are turned off on the post. |
| author_follower_count | Author's follower count. null means not disclosed. |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| top_comments | A few comments shown under the post; each entry has the text (text) and the commenter (author_username). Absent when there are none. |
| product_type | Content format as Instagram classifies it: feed (regular post), clips (Reels), carousel_container (carousel), longform (long video). |
| play_count | Play count. |
| fb_play_count | Play count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| fb_like_count | Like count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| fb_comment_count | Comment count on Facebook, when the author also published this post on Facebook; appears only on such posts. |
| share_count | Shares. null means not disclosed, not 0. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| duration_sec | Duration, in seconds. |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_estimated | true 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_count | Number of images: 1 for a single-image post; for a carousel post, the number of images in it, videos not counted. |
| video_count | Number of videos in a carousel post; only carousel posts have it. |
| video_url_expires_at | Expiry time of video_url, ISO 8601, UTC. |
| video_hd_url | Highest-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_height | Picture height of video_hd_url, in pixels. |
| audio_url | Audio 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_at | Expiry time of video_hd_url, ISO 8601, UTC; audio_url expires at about the same time. |
| is_paid_partnership | Whether the post is marked "Paid partnership". Appears only when the page gives this information, and may be false. |
| is_pinned | Whether 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_hidden | The author hid the like count. Appears only when hidden, with the value true; like_count is usually absent then. |
| caption_is_edited | The caption was edited. Appears only when edited, with the value true. |
| accessibility_caption | Image description that Instagram generates automatically (alternative text, in English). |
| author_is_verified | Whether 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_private | Whether the author's account is private. |
| author_avatar_url | Author avatar URL; signed link that expires. |
| posted_at_estimated | true 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). |
| mentions | Usernames @-mentioned in the text, as an array. |
| tagged_users | Usernames of the people tagged in the images or videos, as an array; for a carousel post, tags on every item count. |
| coauthors | Coauthors: usernames of the accounts credited together with the author on this post, as an array. |
| sponsors | Usernames of the brand accounts named in the paid partnership, as an array. |
| media | Each 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. |
| music | Music 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. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| location_detail | Details 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. |

## Example

```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": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "recommended_reels",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-21T07:18:47Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
