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
curl -X POST "https://api.bridgly.app/instagram/highlights" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "username": "instagram", "count": 3}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/instagram/highlights", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "username": "instagram", "count": 3, },)data = response.json()const response = await fetch("https://api.bridgly.app/instagram/highlights", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "username": "instagram", "count": 3 }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.instagram.getHighlights({ username: "instagram", count: 3});if (res.type === "success") { console.log(res.data);}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
{ "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" } ] }}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.
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.
More Instagram endpoints
The same API key works on every endpoint. See all Instagram API endpoints.
- Instagram Highlight API→Get a saved Instagram highlight and its available stories, including image and video URLs, publish times and dimensions.
- Instagram Post Likers API→Get the liker accounts Instagram exposes for a post or Reel, with usernames, names, profile images and private and verified flags.
- Instagram Comment Replies API→List the accessible replies to an Instagram post comment in chronological order, including text, author, publish time and like count.
- Instagram Location API→Get Instagram location details as JSON: place name, coordinates, category, post count and address information, by location ID or link.
Try the Instagram Highlights API
100 free credits on business email, no card. Your first call takes a minute.