Instagram Highlight Items
Instagram Highlight Items are Story entries saved inside public profile Highlights, with text, author identity, media references, timestamps, and visible engagement signals. These records support highlight content inventories, media review, source-aware reporting, and comparison across known Highlights.
Features
- Multi-highlight inputSubmit one or more numeric highlight IDs, with one upstream lookup made for each supplied identifier.
- Normalized Story item recordsReceive item IDs, public URLs, title or caption text, author identity, visible metrics, media metadata, and timestamps in one record shape.
- Source highlight attributionEach returned item retains the submitted highlight ID in extra.highlight_id so records from multiple Highlights remain distinguishable.
Parameters
| Parameters | Required | Description |
|---|---|---|
highlight_ids | Required | One or more known Instagram highlight IDs represented as non-empty numeric strings, separated by commas or new lines. |
How to Use
Submit known highlight IDs as an asynchronous task, poll its task ID, then read the saved normalized records with result cursor pagination.
- Prepare one or more current numeric highlight IDs; when an ID is unknown, first collect Story Highlights by username and read extra.highlight_id from the returned container record.
- POST highlight_ids to /v1/instagram/highlight-items.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read /v1/tasks/{task_id}?limit=50 and follow results.next_cursor while results.has_more is true.
# Replace the documented sample with a current highlight ID before running.
curl -X POST "https://api.socq.ai/v1/instagram/highlight-items" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"highlight_ids":["18067016518767507"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Saved Story content inventory: Organize returned item IDs, text, public URLs, media references, and timestamps into a reviewable inventory for known Highlights.
- Highlight media review: Inspect image or video URLs, thumbnails, dimensions, duration, captions, and author context for the Story items currently exposed by each Highlight.
- Cross-highlight comparison: Group records by extra.highlight_id and compare returned content types, publication times, authors, and visible metrics across selected Highlights.
Pro Tips
- When highlight IDs are unknown, call instagram/story-highlights by username first and use extra.highlight_id from successful results; this endpoint does not discover IDs from usernames.
- Remove duplicate IDs before submission because the collector performs an independent lookup for every supplied value.
- Do not add results_limit; each highlight ID yields the items available in its single upstream response.
- Use resource to distinguish highlight-items from story-highlights because both normalized record families use type story.
- Treat text, author fields, metrics, media, URLs, and timestamps as optional, and allow unavailable or removed Story items to produce no record.
- Follow results.next_cursor only to read additional stored task records; it does not continue collection from Instagram.
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 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 Story Highlights API — List public Story Highlight containers by username with titles, owner context, media counts, and reusable highlight IDs.
- Instagram Trending Reels API — Capture the current public Reel set from the trending feed with captions, creators, media, timestamps, and visible engagement.