> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_instagram_reels

# get_instagram_reels

> A public Instagram account's reels with plays, likes, comments, caption and video link, with a cursor for more. ₹0.29 per page; a private or missing account is ₹0.

## What it does

The reels of a public Instagram account from `handle` (or `userId`), in `data.reels[]`: caption, play, like and comment counts, video and thumbnail URLs, duration and date, with `data.nextCursor` for `cursor`. Use it to see how an account's short video performs; for photos and carousels [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md), for the profile [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md).

India: any public account.

## Inputs

Generated from the contract captured from staging on 2026-11-05. This tool declares one-of sets: `handle` or `userId` must be present, or it is `invalid_input` for ₹0.

| Field | Type | Required | Description |
|---|---|---|---|
| `cursor` | string | no | Pagination cursor (max_id) from a previous response's nextCursor. |
| `handle` | string | one of | Instagram handle.. e.g. "nasa" |
| `userId` | string | one of | Instagram user id (faster than handle when known). |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `handle`; `userId`.

## What drives the cost

Nothing: flat per page. A private or missing account is `class: "ok_free"`, ₹0. Usually four to ten seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per page (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 47 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_instagram_reels"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_instagram_reels"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_instagram_reels","input":{"handle":"natgeo"}}'
```

## What comes back

`data.reels[]` and `data.nextCursor`. A real answer recorded during the live check of 2026-10-28, trimmed to two reels:

```json
{
  "nextCursor": "cur_2n96c1t-B1xfZ39_n83EeQ",
  "reels": [
    {
      "avatarUrl": "https://scontent-ams2-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg",
      "caption": "Even a moment’s rest on Everest can come with a reminder of just how unpredictable the mountain can be.\n\nFrom Oscar®-winning filmmakers @chaivasarhelyi and @jimmychin, EVEREST: THE OTHER SIDE, only in theaters and IMAX worldwide on October 30.",
      "coauthors": null,
      "comments": 118,
      "countsHidden": null,
      "createdUtc": 1793124003,
      "displayName": "National Geographic",
      "durationSeconds": 68.33000183105469,
      "hashtags": [],
      "id": "4017311023166285121",
      "isPinned": null,
      "likes": 29670,
      "media": [
        {
          "height": 640,
          "type": "video",
          "url": "https://scontent-ams2-1.cdninstagram.com/v/t51.82787-15/865525088_18712762651019133_8954025122327073428_n.jpg",
          "videoUrl": "https://scontent-ams2-1.cdninstagram.com/o1/v/t2/f2/m86/AQO5UaEBuVN5hhSeE2Pjf5XGrwc3N5zJL5pllE6Qdcz-COp0ydRLeOMPAQuK_o4oLpDCoBmjjBwoPGnp7t-I4rSTp6U95gsrdOx9g9c.mp4",
          "width": 360
        }
      ],
      "mentions": [
        "@chaivasarhelyi",
        "@jimmychin"
      ],
      "paidPartnership": false,
      "productType": "clips",
      "reshares": null,
      "shortcode": "DfAWxdIFmVB",
      "soundAuthor": null,
      "soundTitle": null,
      "taggedUsers": [
        {
          "displayName": "Jimmy Chin",
          "username": "jimmychin"
        },
        {
          "displayName": "Chai Vasarhelyi",
          "username": "chaivasarhelyi"
        },
        "… 2 more item(s) truncated"
      ],
      "userId": "787132",
      "username": "natgeo",
      "verified": true,
      "views": 995098
    },
    {
      "avatarUrl": "https://scontent-ams2-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg",
      "caption": "Friendship is important, especially for bonobos. This primate quickly learns that grooming can help break the ice and build new bonds.\n\n#NatGeoQueens is streaming on @DisneyPlus and @hulu.",
      "coauthors": null,
      "comments": 152,
      "countsHidden": null,
      "createdUtc": 1793117056,
      "displayName": "National Geographic",
      "durationSeconds": 82.4739990234375,
      "hashtags": [
        "#NatGeoQueens"
      ],
      "id": "4017278415462892431",
      "isPinned": null,
      "likes": 39182,
      "media": [
        {
          "height": 640,
          "type": "video",
          "url": "https://scontent-ams2-1.cdninstagram.com/v/t51.82787-15/853819244_18712731895019133_270684788486228693_n.jpg",
          "videoUrl": "https://scontent-ams2-1.cdninstagram.com/o1/v/t2/f2/m86/AQOP3Jzk5SV6FU5a9NZRYtdjt14pF5QsHwlG66utFRGZc6xDfpK-zFOx8U0bhnheo0GLJ3-pRmdo4uwn7XpcHpHIC_jEyk2RtIiPB0A.mp4",
          "width": 360
        }
      ],
      "mentions": [
        "@DisneyPlus",
        "@hulu"
      ],
      "paidPartnership": false,
      "productType": "clips",
      "reshares": null,
      "shortcode": "DfAPW81goOP",
      "soundAuthor": null,
      "soundTitle": null,
      "taggedUsers": [],
      "userId": "787132",
      "username": "natgeo",
      "verified": true,
      "views": 882920
    },
    "… 10 more item(s) truncated"
  ]
}
```

## Notes

- About a dozen reels per page; pass data.nextCursor back as cursor.
- Private or missing accounts are free. Usually four to ten seconds.

## Siblings

- [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md) for the rest of the feed.
- [`search_youtube`](https://parel.si/docs/tools/search_youtube.md) for the same creator's long video.
