Instagram Highlights API

Story highlight list by profile

Fetch public Instagram highlight reels for a profile including highlight IDs, titles, cover images, and item counts for downstream story workflows.

1 CreditCost
4+Data Fields
60s MaxTimeout

Quick Start

Get started with a simple API call.

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

const { data } = await response.json();
console.log(data.highlights.map(item => item.title));

Key Features

Everything you need for reliable instagram highlights workflows.

Highlight Discovery

List all public highlight reels available on a profile with IDs ready for follow-up detail calls.

Cover Images

Each highlight includes a cover image URL you can use for dashboards or archives.

Item Counts

See how many story items exist in each highlight before deciding what to fetch next.

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": {
    "highlights": [
      {
        "id": "18223279177302854",
        "title": "Creators",
        "coverUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
        "itemCount": 12
      },
      {
        "id": "17920456789012345",
        "title": "Events",
        "coverUrl": "https://instagram.fist6-1.fna.fbcdn.net/...",
        "itemCount": 7
      }
    ],
    "timing": { "total": 1950 },
    "creditsUsed": 1,
    "creditsRemaining": 99
  }
}

Use Cases

Common applications for Instagram Highlights.

Story Archiving

Discover highlight buckets before pulling their individual items.

Brand Audits

Monitor how brands organize evergreen story content on public profiles.

Creator Research

Map highlight themes and volume across creators or competitors.

Frequently Asked Questions

Everything you need to know about the Instagram Highlights API.

Yes. This endpoint returns the IDs you can pass directly to Instagram Highlight.

No. This only works for public Instagram profiles that expose highlights publicly.

No. This endpoint lists highlights only. Use Instagram Highlight to fetch the items inside a single highlight.

Start Using Instagram Highlights API Today

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