Instagram Current Stories Lookup (by Username or User ID)
omnial/instagram-fetch-user-stories
Given an Instagram username or numeric user ID, returns that account's currently active stories: how many are live, the poster's public profile summary, and per-story detail -- caption, story type (image or video), post and expiry time, any accounts tagged in it, link stickers, and interactive-prompt participation counts. An account with no active stories right now returns a story count of zero and an empty story list 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-user-stories" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/instagram-fetch-user-stories" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/instagram-fetch-user-stories", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/instagram-fetch-user-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
- Nov 6, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"user_id"
]
},
{
"required": [
"username"
]
}
],
"properties": {
"user_id": {
"type": "string",
"examples": [
"18527"
],
"description": "User ID"
},
"username": {
"type": "string",
"examples": [
"instagram"
],
"description": "Username"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"count",
"items"
],
"properties": {
"count": {
"type": "number",
"description": "Number of currently active stories on this account. 0 when none."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string",
"description": "The story's own short share code."
},
"owner": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
}
},
"description": "The story's own poster -- the same account being queried.",
"additionalProperties": true
},
"caption": {
"type": [
"string",
"null"
],
"description": "Usually `null`."
},
"is_video": {
"type": "boolean"
},
"has_audio": {
"type": "boolean",
"description": "Present only on video stories -- absent (not `false`) on image stories."
},
"is_pinned": {
"type": "boolean"
},
"video_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`. Present only on video stories."
},
"media_name": {
"type": "string",
"description": "A content-category label, typically the literal string 'story'."
},
"expiring_at": {
"type": "number",
"description": "Unix seconds this story expires."
},
"media_format": {
"type": "string",
"description": "'image' or 'video'."
},
"product_type": {
"type": "string",
"description": "e.g. 'story'."
},
"reel_mentions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
}
},
"description": "The tagged account's own public profile summary.",
"additionalProperties": true
},
"display_type": {
"type": "string",
"description": "e.g. 'mention_username' or 'mention_reshare'."
}
},
"additionalProperties": true
},
"description": "Accounts the poster tagged in this story. Present only when the story tags at least one account."
},
"story_prompts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"prompt_sticker": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The prompt's own text."
},
"prompt_type": {
"type": "number"
},
"participant_count": {
"type": "number",
"description": "How many accounts have participated so far."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Interactive prompt stickers on the story (e.g. an 'Add Yours' invitation). Present only when the story has one."
},
"taken_at_date": {
"type": "string",
"description": "ISO 8601 posting timestamp."
},
"thumbnail_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"image_versions": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "The story's image at multiple resolutions."
}
},
"additionalProperties": true
},
"video_duration": {
"type": "number",
"description": "Seconds. Present only on video stories."
},
"is_paid_partnership": {
"type": "boolean"
},
"story_link_stickers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"story_link": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"link_type": {
"type": "string",
"description": "e.g. 'web'."
},
"link_title": {
"type": "string"
},
"display_url": {
"type": "string",
"description": "The link's own human-readable display text."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present only when the story has a link sticker attached."
}
},
"additionalProperties": true
},
"description": "One entry per currently active story, typically newest last."
},
"additional_data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story reel's own id."
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The account's numeric Instagram user ID."
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "The account's profile picture. Value withheld (returned as `null` regardless of what the account has set) -- only whether the field is populated is observable, not the image itself."
}
},
"description": "The account's own public profile summary.",
"additionalProperties": true
},
"reel_type": {
"type": "string",
"description": "e.g. 'user_reel'."
},
"expiring_at": {
"type": "number",
"description": "Unix seconds when the whole reel expires."
},
"is_archived": {
"type": "boolean"
},
"latest_reel_media": {
"type": "number",
"description": "Unix seconds the most recent story in this reel was posted."
}
},
"description": "Metadata about the account's current story reel as a whole. Absent when the account has no active stories.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "The current-stories record. `data.additional_data` is present only when the account has at least one active story right now -- otherwise it is absent from the output.",
"additionalProperties": true
}