$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
array
required
List · One per line. Instagram usernames or URLs (profile or direct reel).
integer
default:20
Number · Reels per profile. Use 0 for all.
date
Date picker · Only reels posted on or after this date.
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
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
}
}'
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()
Example response
Response
{
"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"
}
]
}