Instagram Highlight API

Get a saved Instagram highlight and its available stories, including media variants, publish times, author details, mentions, links and shared posts. Saved highlights do not expire. Stories in a highlight are returned together without pagination.

Endpoint: POST /instagram/highlight
Price: 1 credit per request
SDK: client.instagram.getHighlight()
MCP tool: instagram_highlight

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/instagram/highlight" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "highlightId": "18223279177302854"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/instagram/highlight",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "highlightId": "18223279177302854",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/instagram/highlight", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "highlightId": "18223279177302854"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.instagram.getHighlight({
  highlightId: "18223279177302854"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Instagram Highlight API return?

Get a saved Instagram highlight and its available stories, including image and video URLs, publish times and dimensions. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

highlightIdstringrequired: Numeric highlight ID, highlight:<ID>, or an Instagram stories/highlights link.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "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",
    "stories": [
      {
        "id": "string",
        "display_url": "string",
        "video_url": "string",
        "width": 0,
        "height": 0,
        "video_duration": 0,
        "accessibility_caption": "string",
        "image_versions": [
          {
            "url": "string",
            "width": 0,
            "height": 0
          }
        ],
        "video_versions": [
          {
            "url": "string",
            "width": 0,
            "height": 0,
            "type": 0
          }
        ],
        "has_audio": true,
        "video_dash_manifest": "string",
        "number_of_qualities": 0,
        "shortcode": "string",
        "url": "string",
        "type": "Image",
        "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
        },
        "is_edited": true,
        "is_paid_partnership": true,
        "mentions": [
          {
            "username": "string",
            "full_name": "string"
          }
        ],
        "links": [
          "string"
        ],
        "shared_posts": [
          {
            "shortcode": "string",
            "url": "string",
            "product_type": "string"
          }
        ],
        "music": [
          {
            "title": "string",
            "artist": "string"
          }
        ],
        "timestamp": 0,
        "expires_at": 0,
        "caption": "string"
      }
    ]
  }
}

[ USE CASES ]

What can you build with the Instagram Highlight API?

Review a campaign

Inspect the stories saved in a campaign highlight.

Collect evergreen content

Get media links for a public account’s saved stories.

Compare storytelling

Analyze the sequence of stories in a highlight.

[ FAQ ]

Instagram Highlight API questions

How do I use the Instagram Highlight API?

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

How much does the Instagram Highlight API cost?

Costs 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 ENDPOINTS ]

More Instagram endpoints

The same API key works on every endpoint. See all Instagram API endpoints.

Try the Instagram Highlight 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

Book a demo Read the docs