Instagram Story Highlights
Instagram Story Highlights are saved Story collections on public profiles, organized by titles with owner context, cover media, and item counts. These container records support profile category inventories, cross-account comparison, and selection of highlights for item-level review.
Features
- Multi-profile Highlight inventorySubmit one or more Instagram usernames to list the public Story Highlight containers exposed for each account while retaining owner context.
- Container identity and contextReceive normalized Highlight IDs, titles, URLs, owner identity, directly exposed media, timestamps, public counts, and reported item totals.
- Item-level handoffUse extra.highlight_id to retain the container relationship and pass numeric Highlight IDs into item-level collection workflows.
Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | One or more public Instagram usernames as non-empty handles; a leading @ is accepted and removed before collection. |
How to Use
Submit public account usernames as an asynchronous task, poll its task ID, then read normalized Highlight containers with result cursor pagination.
- Prepare one or more public Instagram usernames as handles rather than profile URLs.
- POST usernames to /v1/instagram/story-highlights.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read data.results.items and follow results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Public profile category inventory: Organize Highlight titles, owner identity, URLs, and media counts into an inventory of the saved Story categories visible on a profile.
- Cross-account Highlight comparison: Compare container titles, reported item totals, media references, and available timestamps across submitted public usernames.
- Story collection selection: Use extra.highlight_id with titles and media_count to select numeric Highlight containers for subsequent item-level retrieval.
Pro Tips
- Normalize handles before submission by removing leading @ characters and de-duplicating the resulting usernames, because profile URLs are not converted into handles.
- Expect one Highlight-list request per username with no results_limit or provider continuation, so the available container list determines the records collected for each account.
- Use task-result next_cursor only to page through saved normalized records; it does not request another page of Highlights from Instagram.
- Pass only present numeric extra.highlight_id values to instagram/highlight-items when individual Story frames are required.
- Treat empty results as a possible no-Highlight or unavailable-profile outcome, and omit assumptions about optional media, metrics, URLs, and timestamps.
Related APIs
Use these APIs when you need a different type of public Instagram data.
- Instagram Followers Count API — Retrieve public profile identity and visible follower, following, and post counts.
- Instagram Posts API — Collect public posts, media, hashtags, mentions, timestamps, and engagement by username.
- Instagram Reels API — Collect public Reels, media, audio, hashtags, mentions, and engagement by username.
- Instagram Search API — Search public profiles by keyword or handle with identity and visible account signals.
- Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
- Instagram Profiles API — Retrieve public profile identity, biographies, links, account flags, categories, and visible counts by username.
- Instagram Followers List API — Collect public follower profile records with source-account and relationship context.
- Instagram Following List API — Collect public profiles followed by Instagram accounts with identity, relationship context, and visible account counts.
- Instagram Hashtag Posts API — Discover public posts by hashtag with source-tag context, media, creators, timestamps, and visible engagement.
- Instagram Tagged Posts API — Collect public posts that tag selected profiles with authors, media, mentions, tagged-user context, and engagement.
- Instagram Transcript API — Extract transcript text, language, format, source URLs, and shortcodes from public post or Reel URLs.
- Instagram Audio Reels API — Collect public Reels by known numeric audio ID with captions, creators, media, timestamps, visible engagement, and source-audio context.
- Instagram Highlight Items API — Retrieve saved public Story items from known highlight IDs with text, author identity, media, timestamps, visible metrics, and source context.
- Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.
- Instagram Reels Search API — Search public Reels by text query with captions, creators, media, timestamps, visible engagement, and query context.
- Instagram Trending Reels API — Capture the current public Reel set from the trending feed with captions, creators, media, timestamps, and visible engagement.