Instagram API · Endpoint

Instagram Reels API

Q: What do I send?

Send url. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds instagram.reels.list, checks its price and runs it with the same credits as the REST API.

List a public profile's reels with caption, likes, comments and post time, page by page.

1 credit per call
Failed calls are free
Updated 12 Oct 2026
instagram.reels.list

Start free, 100 credits API reference

Response completed

{  "summary": {    "username": "nasa",    "has_more": true,    "user_id": "528817151"  },  "items": [    {      "data": {        "like_count": 163546,        "comment_count": 1720,        "code": "DeCPVhERA8e",        "id": "3999826868370149150",        "is_video": true,        "like_and_view_counts_disabled": false,        "media_type": 2,        "original_height": 1920,        "original_width": 1080,        "taken_at": 1791036618,        "caption": {          "text": "Room with a view. Check out my new digs as I camp out in Dragon until our departure. With Crew-13’s arrival we have a very full house on th…"        },        "owner": {          "username": "astro_jessica",          "id": "4092263381",          "is_verified": true        },        "coauthor_producers": [          {            "username": "nasa",            "is_verified": true          },          {            "username": "iss",            "is_verified": true          }        ]      }    },    {      "data": {        "like_count": 34281,        "comment_count": 258,        "code": "DeCNJEyOkpq",        "id": "3999817217276004970",        "is_video": true,        "like_and_view_counts_disabled": false,        "media_type": 2,        "original_height": 1920,        "original_width": 1080,        "taken_at": 1791035813,        "caption": {          "text": "From Florida to the front door in under eight hours. 🚀\n\n@nasa’s @spacex Crew-13 lifted off from Cape Canaveral, Florida, at 11:10 a.m. EDT …"        },        "owner": {          "username": "nasajohnson",          "id": "673882723",          "is_verified": true        },        "coauthor_producers": [          {            "username": "nasa",            "is_verified": true          },          {            "username": "nasakennedy",            "is_verified": true          }        ]      }    }  ]}

50 rows

#	Caption	Account	Likes	Comments	Posted (Unix time)	Shortcode
1	Room with a view. Check out my new digs as I camp out in Dragon…	astro_jessica	163,546	1720	1,791,036,618	DeCPVhERA8e
2	From Florida to the front door in under eight hours. 🚀 @nasa’s …	nasajohnson	34,281	258	1,791,035,813	DeCNJEyOkpq
3	There’s no stopping us! NASA’s X-59 completes a record six flig…	nasaaero	42,977	222	1,790,972,870	DeAVuphM4C-
4	What happens when we detect an asteroid that could pose a threa…	nasa	109,452	928	1,790,609,228	Dd1gQBsCWE8
5	Our first Leader of the Uprising 🔥 Tune in on @paramountplus / …	ravens	48,837	608	1,789,924,800	DdhFkS7KGkZ
6	Volume up and get your groove on! A bit of weekend dancing on t…	astro_jessica	240,002	2531	1,789,412,287	DdRyQxKteC1
7	Today’s @nfl flyover in Pittsburgh is just the beginning. This …	nasaadmin	60,675	262	1,789,340,512	DdPsDCWRT-u
8	First-ever @nfl flyover conducted by @nasa 🙌 Thank you to @nasa…	steelers	83,359	318	1,789,319,282	DdPDuIepVPf
9	Star and city trails with aurora. I shot this long exposure (30…	astro_jessica	114,682	227	1,789,232,438	DdMdxJhtdxh
10	Curly-haired crew, this one’s for you! 🌀🚀👩🏻‍🦱 Join me in my tempor…	astro_jessica	126,902	1430	1,788,971,991	DdEsW1ItqpI

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
url	string	yes	The profile's username or URL.	https://www.instagram.com/nasa
cursor	string	no	Pass next_cursor from the last response to get the next page.
limit	integer	no	How many reels to return in this call.
max_pages	integer	no	How many pages to read in this call.
since	integer	no	Only reels from this moment on, as a Unix timestamp.

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
items[].data.like_count	integer	Likes, as Instagram shows them.	163,546
items[].data.comment_count	integer	Comments, as Instagram shows them.	1720
items[].data.taken_at	integer	When it was posted, as a Unix time in seconds.	1,791,036,618
items[].data.code	string	The post's short code, the last part of its link.	DeCPVhERA8e
items[].data.caption	object	The post's caption.	1 fields
items[].data	object	The reel.	13 fields
items[].data.coauthor_producers	array	Accounts credited as co-authors of the post.	2 records
items[].data.id	string	The reel's Instagram ID.	3999826868370149150
items[].data.is_video	boolean	Whether the post is a video.	true
items[].data.like_and_view_counts_disabled	boolean	Whether the account hides like and view counts.	false
items[].data.media_type	integer	Instagram's media type: 1 a photo, 2 a video, 8 a carousel.	2
items[].data.original_height	integer	The photo or video's original height, in pixels.	1920
items[].data.original_width	integer	The photo or video's original width, in pixels.	1080
items[].data.owner	object	The account that posted it.	3 fields
items	array	The account's reels.	50 records
summary	object	Totals and paging details for this answer.	3 fields
summary.has_more	boolean	Whether more reels are available.	true
summary.user_id	string	The account's Instagram ID.	528817151
summary.username	string	The account's username.	nasa

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "instagram.reels.list",  "input": {    "url": "https://www.instagram.com/nasa"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "instagram.reels.list",  "input": {    "url": "https://www.instagram.com/nasa"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "instagram.reels.list",  "input": {    "url": "https://www.instagram.com/nasa"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

Using Upscrape, list NASA's recent Instagram reels and tell me which ones were made with other accounts and how they did against NASA's own.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Instagram

More from the Instagram API

Same data, other platforms

The same data from other platforms

FacebookPage Reels1 credit

Questions

Instagram Reels API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Instagram Reels API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send url. The input fields below list every option with its type and limits.

Do I need an Instagram login?

No. It reads public Instagram data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds instagram.reels.list, checks its price and runs it with the same credits as the REST API.

Get started

Your first Instagram call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call