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": "Observed `null` on every real story calibrated."
},
"is_video": {
"type": "boolean"
},
"location": {
"description": "Observed `null` on every real story calibrated; a populated (geo-tagged) shape was never observed."
},
"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": "Empty on every real story calibrated; item shape unconfirmed."
},
"tagged_users": {
"type": "array",
"items": {},
"description": "Empty on every real story calibrated; item shape unconfirmed."
},
"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 capture (nasa-artemis) observed a private, non-verified individual incidentally tagged here alongside otherwise-public accounts, and `responseShaping` maps this array with one static rule with no per-record conditional on `is_private`, so the same rule must protect every record.",
"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 -- confirmed on the richer (nasa-artemis) fixture only."
},
"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 -- confirmed on the richer (nasa-artemis) fixture only (one comment observed, 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 -- confirmed on the richer (nasa-artemis) fixture only."
},
"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 -- confirmed on the richer (nasa-artemis) fixture only; the narrower (nasa-moontunes) fixture had none."
},
"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 -- confirmed on the richer (nasa-artemis) fixture only."
},
"coauthor_producers": {
"type": "array",
"items": {},
"description": "Empty on every real story calibrated; item shape unconfirmed."
},
"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 -- confirmed on the richer (nasa-artemis) fixture only."
},
"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 -- observed only on the nasa-moontunes fixture (null/absent on nasa-artemis).",
"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 -- confirmed on both real fixtures."
},
"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": "Observed `null` on both real highlights calibrated; a populated shape was never observed."
},
"full_image_version": {
"description": "Observed `null` on both real highlights calibrated; a populated shape was never observed."
},
"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, as returned at routing.responseResultPath ($.output). No fixture with a nonexistent/expired highlight_id ships in this tool's examples/ (a genuinely $0-cost empty result was deleted, see this file's header) -- an empty-shell response for that case is UNCONFIRMED in this schema and described only in usage.md prose.",
"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
- Sep 23, 2026