Instagram Saved Highlight Items API
Get the saved stories inside one highlight collection, from the profile and collection ID.
- 1 credit per call
- Failed calls are free
- Updated
- instagram.highlights.items.get
{ "summary": { "available_on_page": 1, "collection_id": "18195781759377100", "continuation_supported": false, "owner_id": "528817151", "owner_username": "nasa" }, "items": [ { "id": "3975089864169193671_528817151", "media_id": "3975089864169193671", "media_type": 2, "taken_at": 1788087653 } ]}
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| collection_id | string | yes | Collection identifier. | 18195781759377100 |
| username | string | yes | nasa | |
| limit | integer | no | Maximum number of results to return. From 1 to 100. Default: 100. |
10 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].id | string | The highlight item's ID. | 3975089864169193671_528817151 |
| items[].media_id | string | The ID of the photo or video. | 3975089864169193671 |
| items[].media_type | integer | Instagram's media type: 1 a photo, 2 a video, 8 a carousel. | 2 |
| items[].taken_at | integer | When it was posted, as a Unix time in seconds. | 1,788,087,653 |
| items | array | The photos and videos saved in the highlight. | 1 records |
| summary | object | Totals and paging details for this answer. | 5 fields |
| summary.available_on_page | integer | How many items the highlight shows. | 1 |
| summary.collection_id | string | The highlight's ID, from the highlights list. | 18195781759377100 |
| summary.continuation_supported | boolean | Whether a next page can be requested; always false here. | false |
| summary.owner_id | string | The account's Instagram ID. | 528817151 |
| summary.owner_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.items.get", "input": { "collection_id": "18195781759377100", "limit": 10, "username": "nasa" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "instagram.highlights.items.get", "input": { "collection_id": "18195781759377100", "limit": 10, "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.items.get", "input": { "collection_id": "18195781759377100", "limit": 10, "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 saved highlight items for collection id "18195781759377100" and 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 Highlights API1 credit
- Instagram Basic Profile by ID API1 credit
- Instagram Location API1 credit
- Instagram Embed API1 credit
Instagram Saved Highlight Items API FAQ
The short answers. The docs have the long ones.
How much does the Instagram Saved Highlight Items 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 and collection_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.highlights.items.get, 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.