> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram Reels

> Get Instagram Reels and their metadata — caption, transcript, hashtags, engagement, duration, and video file — using a username

`$0.9 / 1k reels`

Get Instagram Reels and their metadata — caption, transcript, hashtags, engagement, duration, and video file — using a username

## Endpoint

`POST /api/v1/agents/instagram/reels/run`

## Parameters

<ParamField body="username" type="array" required>
  **List** · One per line. Instagram usernames or URLs (profile or direct reel).
</ParamField>

<ParamField body="maxResults" type="integer" default={20}>
  **Number** · Reels per profile. Use 0 for all.
</ParamField>

<ParamField body="onlyReelsNewerThan" type="date">
  **Date picker** · Only reels posted on or after this date.
</ParamField>

## Response columns

| Field              | Display name      | Type    |
| ------------------ | ----------------- | ------- |
| `profileUrl`       | Profile URL       | url     |
| `reelUrl`          | Reel URL          | url     |
| `caption`          | Caption           | text    |
| `posted`           | Posted            | text    |
| `author`           | Author            | text    |
| `authorName`       | Author Name       | text    |
| `coverImage`       | Cover Image       | url     |
| `videoUrl`         | Video URL         | url     |
| `audioUrl`         | Audio URL         | url     |
| `durationS`        | Duration (s)      | number  |
| `likes`            | Likes             | number  |
| `comments`         | Comments          | number  |
| `plays`            | Plays             | number  |
| `views`            | Views             | number  |
| `song`             | Song              | text    |
| `artist`           | Artist            | text    |
| `originalAudio`    | Original Audio    | boolean |
| `hashtags`         | Hashtags          | text    |
| `mentions`         | Mentions          | text    |
| `coauthor`         | Coauthor          | text    |
| `taggedUser`       | Tagged User       | text    |
| `commentsDisabled` | Comments Disabled | boolean |
| `pinned`           | Pinned            | boolean |
| `productType`      | Product Type      | text    |
| `type`             | Type              | text    |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/instagram/reels/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "username": [
        "natgeo"
      ],
      "maxResults": 10
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/instagram/reels/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "username": [
          "natgeo"
      ],
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "profileUrl": "https://www.instagram.com/natgeo",
      "reelUrl": "https://www.instagram.com/p/DXvSRu9lRnB/",
      "caption": "Around the globe, a growing cadre of bee researchers is trying to measure and understand how bees change their behaviors to solve and survive new challenges. And that means dreaming up ever more outlandish obstacle courses. In one case, researchers in Finland are seeing if bumblebees can use a ball as a tool to reach a sugary reward. The results are helping deepen our understanding of insect intelligence.\n\nLearn more about the sneaky genius of nature's brightest thinkers at the link in bio.\n\n#SecretsOfTheBees is now streaming on @DisneyPlus and @hulu.",
      "posted": "2026-04-30T10:00:04.000Z",
      "author": "natgeo",
      "authorName": "National Geographic",
      "coverImage": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-15/682435074_18653284363019133_2727605991356414472_n.jpg?stp=dst-jpg_e15_fr_p1080x1080_tt6&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGjaD_2O4cB4YV_fs0joVUw0wixQGZcskYbWFG6WanmeAjFtkCiqc3Rqm_mcWPvFqU&_nc_ohc=N3nguA7BgFcQ7kNvwHwPhuu&_nc_gid=IGaGaNLVMBtVEZyPl522Dw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Af7_qyN7-zcGrwBSIsp56DdzPO8adQ0PfTlpV47yTl6BWA&oe=69FA6896&_nc_sid=10d13b",
      "videoUrl": "https://scontent-phl2-1.cdninstagram.com/o1/v/t16/f2/m86/AQPhdJWjNUOZ3pda2aLVydZvaybsj1wF3AO8RdX2Xi2Z820tOBazAM6dAEJPjau13Sy4JmIpw9qk4J_BwFYy9v0E1kf50B4y5biNZ3A.mp4?stp=dst-mp4&efg=eyJxZV9ncm91cHMiOiJbXCJpZ193ZWJfZGVsaXZlcnlfdnRzX290ZlwiXSIsInZlbmNvZGVfdGFnIjoidnRzX3ZvZF91cmxnZW4uY2xpcHMuYzIuNzIwLmJhc2VsaW5lIn0&_nc_cat=105&vs=992215633764649_383536683&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yNjRGOTIyREQ1Rjk3RjVBNzI4RjI4NEYwMEM4QzJBRl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0U1NDYzMkI1N0UyRDZFQUUxNjc0QkQxNzNENkI1Njk2X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwAVAAAmlqrpnu3c5z8VAigCQzMsF0BUR0vGp%2B%2BeGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX%2BB2XmnQEA&_nc_rid=1ce9184451&ccb=9-4&oh=00_Af4vHPBeB-tAaqMLqfUhXErXUMM3AYOCVpBR9Y0GoH3nSQ&oe=69F68B74&_nc_sid=10d13b",
      "audioUrl": "https://scontent-phl2-1.cdninstagram.com/o1/v/t2/f2/m78/AQPeEZHbUlL79Sw2Kfq1dNGmhRrXsaBHhFJGcuCu9EkcS7h92x5ztfg5W-zn_fqIYZ2xLdquyBSMb8NFkOvJZ7ISxGYUMu7P4kUAGAM.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_ohc=JV_Nvi5pIs4Q7kNvwEpWuW8&efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLmNsaXBzLmMyLUMzLmRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6OTM2NjE5NzQzMzkyNDU5LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxNzk2MTAxODE0NDExMDYwMywiYXNzZXRfYWdlX2RheXMiOjEsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjo4MSwiYml0cmF0ZSI6NTEwNjYsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=IGaGaNLVMBtVEZyPl522Dw&_nc_zt=28&_nc_ss=7a22e&oh=00_Af4CUAxEN2HynAlgb2bIH5HjVBN6AdLDiwrpjdNq3-7oYA&oe=69F67A9B",
      "durationS": 81.131,
      "likes": 25042,
      "comments": 194,
      "plays": 2378878,
      "views": 797812,
      "song": "Original audio",
      "artist": "natgeo",
      "originalAudio": true,
      "hashtags": [
        "SecretsOfTheBees"
      ],
      "mentions": [
        "DisneyPlus",
        "hulu."
      ],
      "coauthor": null,
      "taggedUser": null,
      "commentsDisabled": false,
      "pinned": false,
      "productType": "clips",
      "type": "Video"
    }
  ]
}
```