Instagram Highlight Stories (by Highlight ID)
omnial/instagram-fetch-highlight-stories
Given a numeric Instagram highlight-reel ID, returns every story saved in that highlight: each story's caption, capture time, media type and duration (image/video URLs withheld), and any stickers overlaid on it -- mentioned/tagged accounts, countdowns, polls/questions, public comments, music credits, and shared links -- plus the highlight's own title and owner account. A highlight ID that no longer resolves returns an empty shell rather than an error.
activeper callv2
Price
Up to $0.0041 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Instagram.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/instagram-fetch-highlight-stories" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/instagram-fetch-highlight-stories" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/instagram-fetch-highlight-stories", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/instagram-fetch-highlight-stories", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0041 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"highlight_id"
],
"properties": {
"highlight_id": {
"type": "string",
"examples": [
"17895069621772257"
],
"description": "The numeric Instagram highlight-reel ID (e.g. from a highlight's own URL or a prior lookup), not a username or a post shortcode."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of stories in `items`."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string",
"description": "The story's public shortcode."
},
"caption": {
"type": [
"string",
"null"
],
"description": "Usually `null`."
},
"is_video": {
"type": "boolean"
},
"location": {
"description": "Usually `null`; a populated (geo-tagged) shape is not documented."
},
"taken_at": {
"type": "number",
"description": "Unix seconds."
},
"has_audio": {
"type": "boolean"
},
"is_pinned": {
"type": "boolean"
},
"video_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"media_type": {
"type": "number",
"description": "1 (image) or 2 (video) on real stories observed."
},
"video_codec": {
"type": "string",
"description": "Present only on video items."
},
"media_format": {
"type": "string",
"description": "e.g. `video`, `image`."
},
"product_type": {
"type": "string",
"description": "`story` on every real item observed."
},
"sponsor_tags": {
"type": "array",
"items": {},
"description": "Usually empty; item shape not documented."
},
"tagged_users": {
"type": "array",
"items": {},
"description": "Usually empty; item shape not documented."
},
"reel_mentions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"full_name": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_id": {
"type": "string"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
}
},
"description": "The tagged account. `full_name`/`username` are withheld (stripped to `null`) for every entry in this array, not only private ones -- one real call observed a private, non-verified individual incidentally tagged here alongside otherwise-public accounts, and the same rule applies to every record (there is no per-record check on `is_private`).",
"additionalProperties": true
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"end_time_ms": {
"type": "number"
},
"display_type": {
"type": "string"
},
"start_time_ms": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "One entry per individually-mentioned account tagged in the story."
},
"taken_at_date": {
"type": "string",
"description": "ISO 8601."
},
"thumbnail_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"fundraiser_tag": {
"type": "object",
"properties": {
"has_standalone_fundraiser": {
"type": "boolean"
}
},
"additionalProperties": true
},
"group_mentions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"id": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"attribution": {
"type": "string"
},
"end_time_ms": {
"type": "number"
},
"start_time_ms": {
"type": "number"
},
"group_mention_sticker": {
"type": "object",
"properties": {
"text": {
"type": [
"string",
"null"
]
},
"mentioned_users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_id": {
"type": "string"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"sticker_style_enum": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "A single sticker that mentions multiple accounts at once -- absent on highlights without one."
},
"image_versions": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"original_width": {
"type": "number"
},
"story_comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_id": {
"type": "string"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
}
},
"additionalProperties": true
},
"created_at": {
"type": "number",
"description": "Unix seconds."
}
},
"additionalProperties": true
},
"description": "Public comments left on this story -- present only on some highlights (e.g. one comment from a verified organization account)."
},
"video_duration": {
"type": "number",
"description": "Seconds. Present only on video items."
},
"video_versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"type": {
"type": "number"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"bandwidth": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Present only on video items -- one entry per available encoding."
},
"highlights_info": {
"type": "object",
"properties": {
"added_to": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"reel_id": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Every highlight this story has been added to."
}
},
"additionalProperties": true
},
"original_height": {
"type": "number"
},
"story_questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"id": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"end_time_ms": {
"type": "number"
},
"start_time_ms": {
"type": "number"
},
"question_sticker": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"question_type": {
"type": "string"
},
"response_types": {
"type": "array",
"items": {
"type": "string"
}
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"viewer_can_interact": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present on stories with a question/poll sticker -- absent on highlights without one."
},
"story_countdowns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"id": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"end_time_ms": {
"type": "number"
},
"start_time_ms": {
"type": "number"
},
"countdown_sticker": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"end_ts": {
"type": "number",
"description": "Unix seconds the countdown ends."
},
"countdown_id": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present on stories with a countdown sticker -- absent on highlights without one."
},
"story_feed_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"media_code": {
"type": "string",
"description": "The linked post's own public shortcode."
},
"end_time_ms": {
"type": "number"
},
"product_type": {
"type": "string"
},
"start_time_ms": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "A linked feed post (e.g. a Reel) attached to the story -- absent on highlights without one."
},
"coauthor_producers": {
"type": "array",
"items": {},
"description": "Usually empty; item shape not documented."
},
"is_paid_partnership": {
"type": "boolean"
},
"story_link_stickers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"id": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"story_link": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
},
"link_type": {
"type": "string"
},
"link_title": {
"type": "string"
},
"display_url": {
"type": "string",
"description": "The visible domain/path text, not a fetchable URL."
}
},
"additionalProperties": true
},
"end_time_ms": {
"type": "number"
},
"start_time_ms": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Present on stories with a shared link -- absent on highlights without one."
},
"story_music_stickers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"id": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"rotation": {
"type": "number"
},
"end_time_ms": {
"type": "number"
},
"start_time_ms": {
"type": "number"
},
"music_asset_info": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"audio_id": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"artist_id": {
"type": [
"string",
"null"
]
},
"ig_artist": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_id": {
"type": "string"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
}
},
"description": "The credited artist's own Instagram account, when linked -- null/absent otherwise.",
"additionalProperties": true
},
"has_lyrics": {
"type": "boolean"
},
"ig_username": {
"type": [
"string",
"null"
],
"description": "The credited artist's own Instagram handle, when linked."
},
"is_explicit": {
"type": "boolean"
},
"display_artist": {
"type": "string"
},
"duration_in_ms": {
"type": "number"
},
"licensed_music_subtype": {
"type": "string"
},
"placeholder_profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Value withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present on stories with a music sticker."
},
"gen_ai_detection_method": {
"type": "object",
"properties": {
"detection_method": {
"type": "string",
"description": "`NONE` on every real story observed."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "One entry per story saved in the highlight. 20 entries on both real highlights observed."
},
"additional_data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "e.g. `highlight:18201653992314974`."
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_id": {
"type": "string"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "The owner's avatar image URL. Value withheld (stripped to `null`)."
}
},
"description": "The highlight's own owner account.",
"additionalProperties": true
},
"title": {
"type": "string"
},
"reel_type": {
"type": "string",
"description": "`highlight_reel` on both real highlights observed."
},
"created_at": {
"type": "number",
"description": "Unix seconds."
},
"cover_media": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"crop_rect": {
"description": "Usually `null`; the shape of a populated value is not documented."
},
"full_image_version": {
"description": "Usually `null`; the shape of a populated value is not documented."
},
"cropped_image_version": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Cover thumbnail URL. Value withheld (stripped to `null`)."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"is_archived": {
"type": "boolean"
},
"latest_reel_media": {
"type": "number",
"description": "Unix seconds of the most recent story added."
},
"highlight_reel_type": {
"type": "string",
"description": "`DEFAULT` on both real highlights observed."
},
"is_pinned_highlight": {
"type": "boolean"
},
"disabled_reply_types": {
"type": "array",
"items": {
"type": "string"
}
},
"is_added_to_main_grid": {
"type": "boolean"
},
"is_converted_to_clips": {
"type": "boolean"
}
},
"description": "The highlight's own metadata and owner account.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "The highlight record. The shape returned for a nonexistent/expired highlight_id is not described in this schema; see usage.md.",
"additionalProperties": true
}