INSTAGRAM API

Instagram Highlights API

List saved story highlights on a public Instagram profile, including highlight IDs, titles and cover images. Use a highlight ID with the highlight endpoint to retrieve its stories. Continue with nextCursor.

Endpoint
POST /instagram/highlights
Price
1 credit per result
SDK
client.instagram.getHighlights()
MCP tool
instagram_highlights
Terminal
curl -X POST "https://api.bridgly.app/instagram/highlights" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "instagram",
"count": 3
}'
[ REQUEST AND RESPONSE ]

What does the Instagram Highlights API return?

List saved Instagram story highlights as JSON, with highlight IDs, titles, cover images and owner information. Follow cursors for more results. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

usernamestringrequired
Instagram username, or the profile link, e.g. "instagram" or "https://www.instagram.com/instagram/"
countinteger · 1–10 · default 10
Number of results to return (1–10). Defaults to 10.
cursorstring
The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json
{
"timeMs": 1840,
"creditsCost": 1,
"data": {
"nextCursor": "string",
"highlights": [
{
"id": "string",
"title": "string",
"cover_url": "string",
"owner_id": "string",
"owner": {
"id": "string",
"username": "string",
"full_name": "string",
"profile_pic_url": "string",
"is_private": true,
"is_verified": true,
"profile_pic_id": "string",
"latest_reel_media": 0,
"is_mentionable": true
},
"latest_story_at": 0,
"username": "string",
"url": "string"
}
]
}
}
[ USE CASES ]

What can you build with the Instagram Highlights API?

Explore a brand

Find the topics an account groups into highlights.

Discover saved campaigns

Identify highlights to inspect for campaign content.

Track profile changes

Compare highlight titles and covers over time.

[ FAQ ]

Instagram Highlights API questions

How do I use the Instagram Highlights API?

Send a POST request to https://api.bridgly.app/instagram/highlights with username in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.instagram.getHighlights(). AI agents connected to Bridgly over MCP can call the instagram_highlights tool.

How much does the Instagram Highlights API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try the Instagram Highlights API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits