Instagram API · Endpoint

Instagram Reels by Audio API

Q: What do I send?

Send audio_id. 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.audio-reels.list, checks its price and runs it with the same credits as the REST API.

List the public reels that use one audio track, from its audio ID.

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

Start free, 100 credits API reference

Response completed

{  "summary": {    "audio_id": "28601503179449709",    "has_more": false,    "pages": 2  },  "items": [    {      "data": {        "media": {          "like_count": 66971,          "comment_count": 668,          "code": "Da5ynsiuAZ_",          "has_audio": true,          "id": "3943405578951853695",          "ig_play_count": 5335810,          "is_paid_partnership": false,          "like_and_view_counts_disabled": false,          "media_type": 2,          "original_height": 1920,          "original_width": 1080,          "pk": "3943405578951853695",          "play_count": 5335810,          "product_type": "clips",          "taken_at": 1784311011,          "video_duration": 75.492,          "caption": {            "text": "Mars in motion! ⏩ \n\nOur Psyche spacecraft is on its way to explore a rare, metal-rich asteroid. In May, Psyche got a speed boost by flying …",            "created_at": 1784311011          },          "image_versions2": {            "candidates": [              {                "height": 1594,                "width": 898              },              {                "height": 1278,                "width": 720              }            ]          },          "user": {            "full_name": "NASA Jet Propulsion Laboratory",            "username": "nasajpl",            "is_verified": true          },          "coauthor_producers": [            {              "full_name": "NASA",              "username": "nasa",              "is_verified": true            },            {              "full_name": "NASA Solar System Exploration",              "username": "nasasolarsystem",              "is_verified": true            }          ],          "video_versions": [            {              "height": 1280,              "type": 101,              "width": 720            },            {              "height": 1280,              "type": 102,              "width": 720            }          ]        }      }    },    {      "data": {        "media": {          "like_count": 1,          "comment_count": 0,          "code": "DbDoBTmAg94",          "has_audio": true,          "id": "3946173710125371256",          "ig_play_count": 154,          "is_paid_partnership": false,          "like_and_view_counts_disabled": false,          "media_type": 2,          "original_height": 720,          "original_width": 1280,          "pk": "3946173710125371256",          "play_count": 154,          "product_type": "clips",          "taken_at": 1784640619,          "video_duration": 50.513,          "caption": {            "text": "סוכנות החלל NASA הציגה: https://science.nasa.gov/photojournal/the-growing-crescent-of-mars-as-nasas-psyche-mission-approaches/ טיים־לאפס של…",            "created_at": 1784640620          },          "image_versions2": {            "candidates": [              {                "height": 360,                "width": 640              },              {                "height": 270,                "width": 480              }            ]          },          "user": {            "full_name": "TechNews",            "username": "technewsheb",            "is_verified": false          },          "coauthor_producers": [],          "video_versions": [            {              "height": 720,              "type": 101,              "width": 1280            },            {              "height": 720,              "type": 102,              "width": 1280            }          ]        }      }    }  ]}

#
1
2

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
audio_id	string	yes	Audio cluster ID from an Instagram /reels/audio/{id}/ URL	28601503179449709
cursor	string	no	Continuation cursor returned by a previous request.
limit	integer	no	Maximum number of results to return. From 1 to 200. Default: `30`.	12
max_pages	integer	no	Maximum number of result pages to fetch. From 1 to 20. Default: `5`.	2

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	object	The reel.	1 fields
items[].data.media	object	The reel's details.	21 fields
items	array	The reels that use this audio.	2 records
summary	object	Totals and paging details for this answer.	3 fields
summary.audio_id	string	The audio's Instagram ID.	28601503179449709
summary.has_more	boolean	Whether more reels with this audio are available.	false
summary.pages	integer	How many result pages were read for this answer.	2

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.audio-reels.list",  "input": {    "audio_id": "28601503179449709",    "limit": 12,    "max_pages": 2  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "instagram.audio-reels.list",  "input": {    "audio_id": "28601503179449709",    "limit": 12,    "max_pages": 2  }}''')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.audio-reels.list",  "input": {    "audio_id": "28601503179449709",    "limit": 12,    "max_pages": 2  }}),});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

With Upscrape, get the Instagram reels by audio for audio id "28601503179449709". Tell me what it costs before you run it, then show the results as a table.

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 by Audio 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 by Audio 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 audio_id. 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.audio-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