GET
/instagram/user/highlightsGet Instagram Story Highlights
Get all story highlights for an Instagram user by user ID or handle. Returns highlight titles, cover images, and metadata.
Quick Start
cURL
curl "https://api.creatorcrawl.com/v1/instagram/user/highlights?handle=brand_account" \
-H "x-api-key: YOUR_API_KEY"Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | Optional | Instagram user ID (provide user_id or handle) |
handle | string | Optional | Instagram handle without @ (provide handle or user_id) |
Response
JSON Response
{
"success": true,
"highlights": [
{
"id": "18067016518767507",
"title": "Product Launch",
"cover_media": {
"thumbnail_src": "https://..."
},
"owner": {
"username": "brand_account"
}
}
]
}Every request costs 1 credit. Response data is live -- never cached.
Use Cases
Brand monitoring
Track what stories brands and creators are pinning as highlights on their Instagram profiles.
Content archival
Catalog and archive story highlight metadata for Instagram creators you track.
Competitive analysis
Analyze how competitors organize their Instagram story highlights to inform your content strategy.
Code Examples
Python
import requests
resp = requests.get(
"https://api.creatorcrawl.com/v1/instagram/user/highlights",
params={"handle": "brand_account"},
headers={"x-api-key": "YOUR_API_KEY"},
)
for highlight in resp.json()["highlights"]:
print(f"{highlight['title']} (ID: {highlight['id']})")JavaScript
const resp = await fetch(
"https://api.creatorcrawl.com/v1/instagram/user/highlights?handle=brand_account",
{ headers: { "x-api-key": "YOUR_API_KEY" } }
)
const { highlights } = await resp.json()
highlights.forEach(h => console.log(`${h.title} (ID: ${h.id})`))