Instagram Highlight API

Highlight detail and story items

Fetch the individual story items inside one public Instagram highlight including media URLs, expiry timestamps, and media types.

Try It Free View Docs
1 CreditCost
6+Data Fields
60s MaxTimeout

Quick Start

Get started with a simple API call.

const response = await fetch('https://api.crawlkit.sh/v1/crawl/instagram/highlight', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    highlightId: '18223279177302854',
    options: {
      timeout: 30000
    }
  })
});

const { data } = await response.json();
console.log(data.highlight.title, data.items.length);

Key Features

Everything you need for reliable instagram highlight workflows.

Story Items

Returns the stories inside a single highlight with normalized media URLs and timing metadata.

Media Type Labels

Each item clearly identifies whether it is an image, video, or carousel-style media object.

Expiry Metadata

Use takenAt and expiresAt to reason about story timing and storage behavior.

Detail-First Workflow

Pair this with Instagram Highlights to discover highlight IDs and then fetch the full item list.

How It Works

Get started in minutes with our simple API.

1

Get Your API Key

Sign up for free and get your API key instantly. No credit card required.

2

Make Your First Request

Use our simple REST API with your favorite programming language.

3

Get Structured Data

Receive clean JSON responses ready to use in your application.

API Response

Get clean, structured JSON data with every request. Our API returns comprehensive data including status codes, timing information, and your remaining credits.

  • Consistent JSON structure
  • Detailed timing metrics
  • Credit usage tracking
  • Error handling built-in
Response
{
  "success": true,
  "data": {
    "highlight": {
      "id": "18223279177302854",
      "title": "Creators",
      "coverUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
      "itemCount": 12
    },
    "items": [
      {
        "id": "35781234000123456",
        "mediaType": "video",
        "displayUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
        "videoUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
        "thumbnailUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
        "takenAt": 1711209000,
        "expiresAt": 1711295400
      }
    ],
    "timing": { "total": 1850 },
    "creditsUsed": 1,
    "creditsRemaining": 99
  }
}

Use Cases

Common applications for Instagram Highlight.

Story Archiving

Capture story items that remain publicly visible inside highlight reels.

Brand Intelligence

Analyze how brands structure evergreen stories across campaigns and topics.

Creative Pipelines

Feed story media into downstream review or enrichment workflows.

Frequently Asked Questions

Everything you need to know about the Instagram Highlight API.

Call Instagram Highlights first. It returns the IDs for each public highlight reel on the profile.

Yes. The endpoint accepts either the numeric highlight ID or a public highlight URL and normalizes it.

Only items still publicly available through the highlight reel are returned.

Start Using Instagram Highlight API Today

Get 100 free credits to test the API. No credit card required.

Get Started Free View Pricing