Instagram Highlights API
List a public profile's story highlights: each collection's title and ID.
- 1 credit per call
- Failed calls are free
- Updated
- instagram.highlights.list
{ "summary": { "username": "nasa", "available_on_page": 5, "continuation_supported": false, "user_id": "528817151" }, "items": [ { "data": { "title": "Roman", "id": "18195781759377100", "owner_username": "nasa", "url": "https://www.instagram.com/stories/highlights/18195781759377100/" } }, { "data": { "title": "Wallpapers", "id": "18123023338592759", "owner_username": "nasa", "url": "https://www.instagram.com/stories/highlights/18123023338592759/" } } ]}
| # |
|---|
| 1 |
| 2 |
| 3 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| username | string | yes | Public Instagram username | nasa |
| limit | integer | no | Maximum highlight collections from the public tray; this endpoint returns collection metadata without continuation From 1 to 10. Default: 10. |
5 |
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.title | string | The highlight's title. | Roman |
| items[].data | object | The highlight. | 4 fields |
| items[].data.id | string | The highlight's ID; send it to the highlight items endpoint. | 18195781759377100 |
| items[].data.owner_username | string | The account's username. | nasa |
| items[].data.url | string | The highlight's link on Instagram. | https://www.instagram.com/stories/highlights/18195781759377100/ |
| items | array | The profile's highlights. | 3 records |
| summary | object | Totals and paging details for this answer. | 4 fields |
| summary.available_on_page | integer | How many highlights the profile shows. | 5 |
| summary.continuation_supported | boolean | Whether a next page can be requested; always false here. | false |
| summary.user_id | string | The account's Instagram ID. | 528817151 |
| summary.username | string | The account's username. | nasa |
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.highlights.list", "input": { "limit": 5, "username": "nasa" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "instagram.highlights.list", "input": { "limit": 5, "username": "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.highlights.list", "input": { "limit": 5, "username": "nasa" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the Instagram highlights for username "nasa". Tell me what it costs before you run it, then show the results as a table.
More from the Instagram API
- Instagram Profile API1 credit
- Instagram Profile Posts API1 credit
- Instagram Reels API1 credit
- Instagram Post API1 credit
- Instagram Comments API1 credit
- Instagram Hashtag Posts Search API1 credit
- Instagram Hashtag Keyword Search API1 credit
- Instagram Popular Search API1 credit
- Instagram Topic Search API1 credit
- Instagram Topics API1 credit
- Instagram Profiles Search API1 credit
- Instagram Reels Search API1 credit
- Instagram Explore API1 credit
- Instagram Reels by Audio API1 credit
- Instagram Saved Highlight Items API1 credit
- Instagram Basic Profile by ID API1 credit
- Instagram Location API1 credit
- Instagram Embed API1 credit
Instagram Highlights API FAQ
The short answers. The docs have the long ones.
How much does the Instagram Highlights 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 username. 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.highlights.list, checks its price and runs it with the same credits as the REST API.
Your first Instagram call is free.
Up to 100 free credits to start, no card needed.