Contract
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.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
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.004095 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Oct 12, 2026