Twitter/X Media Timeline (by Username)
omnial/twitter-web-fetch-user-media
Given a Twitter/X username, returns that account's most recent tweets that carry photo or video media, each with engagement counts (likes, retweets, replies, quotes, bookmarks, view count), media type and dimensions/duration, and quoted-tweet context when a media tweet quotes another public tweet, plus the account's own profile summary (display name, verification status, follower/tweet counts). Tweet caption text and raw media file URLs are withheld, not included in the response.
activeper callv3
Price
Up to $0.00205 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 X (Twitter).
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/twitter-web-fetch-user-media" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/twitter-web-fetch-user-media" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/twitter-web-fetch-user-media", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/twitter-web-fetch-user-media", 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.00205 |
- Updated
- Nov 6, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"screen_name"
],
"properties": {
"cursor": {
"type": "string",
"description": "Page Cursor"
},
"rest_id": {
"type": "integer",
"examples": [
"44196397"
],
"description": "User ID"
},
"screen_name": {
"type": "string",
"examples": [
"elonmusk"
],
"description": "Screen Name"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string",
"description": "Typically 'active'."
},
"friends": {
"type": "number"
},
"profile": {
"type": "string",
"description": "The account's own screen name, duplicated from `screen_name` elsewhere."
},
"rest_id": {
"type": "string"
},
"website": {
"type": "string",
"description": "Present only when the account has published a bio link (e.g. jack)."
},
"location": {
"type": "string",
"description": "Free-text profile location; observed empty on both real accounts."
},
"protected": {
"type": "boolean"
},
"sub_count": {
"type": "number",
"description": "Follower count."
},
"affiliates": {
"type": "object",
"properties": {
"label": {
"type": "object",
"properties": {
"url": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"urlType": {
"type": "string"
}
},
"additionalProperties": true
},
"badge": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"description": {
"type": "string"
},
"userLabelType": {
"type": "string"
},
"userLabelDisplayType": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "The business affiliation badge shown on the account (e.g. \"This account is Premium because it's an affiliate of @X\").",
"additionalProperties": true
},
"created_at": {
"type": "string"
},
"media_count": {
"type": "number"
},
"blue_verified": {
"type": "boolean"
},
"statuses_count": {
"type": "number"
},
"business_account": {
"type": "array",
"items": {},
"description": "Observed as an empty array on both real accounts."
},
"verification_type": {
"type": "object",
"properties": {
"reason": {
"type": "object",
"properties": {
"description": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"entities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ref": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld the same way as other URL fields."
},
"url_type": {
"type": "string"
}
},
"additionalProperties": true
},
"to_index": {
"type": "number"
},
"from_index": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"verified_since_msec": {
"type": "string"
},
"override_verified_year": {
"type": "number",
"description": "Present only for some accounts (e.g. elonmusk)."
}
},
"description": "The account's Premium/affiliate verification badge explanation.",
"additionalProperties": true
},
"is_identity_verified": {
"type": "boolean"
}
},
"additionalProperties": true
},
"pinned_tweet_ids_str": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "The queried account's own profile.",
"additionalProperties": true
},
"status": {
"type": "string",
"description": "Typically 'ok'."
},
"timeline": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"media": {
"type": "object",
"properties": {
"photo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Withheld -- returned null regardless of the real image URL."
}
},
"additionalProperties": true
}
},
"video": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"duration": {
"type": "number",
"description": "Milliseconds."
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld the same way as other media URLs."
},
"bitrate": {
"type": "number",
"description": "Absent on the manifest (m3u8) variant."
},
"content_type": {
"type": "string"
}
},
"additionalProperties": true
}
},
"aspect_ratio": {
"type": "array",
"items": {
"type": "number"
}
},
"original_info": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"focus_rects": {
"type": "array",
"items": {},
"description": "Observed empty on the one real video captured."
}
},
"additionalProperties": true
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Thumbnail image, withheld the same way as photo.media_url_https."
}
},
"additionalProperties": true
},
"description": "Present only for some tweets (e.g. seen for elonmusk)."
}
},
"description": "Present with a `photo` and/or `video` array when the tweet carries media; an empty array `[]` on non-media tweets.",
"additionalProperties": true
},
"views": {
"type": "string",
"description": "Numeric string, e.g. '12531622'."
},
"author": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"avatar": {
"type": [
"string",
"null"
],
"description": "Observed as null on every timeline entry in testing."
},
"rest_id": {
"type": "string"
},
"screen_name": {
"type": "string"
},
"blue_verified": {
"type": "boolean"
}
},
"description": "The tweet author -- the queried account itself for every top-level timeline entry observed.",
"additionalProperties": true
},
"quoted": {
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"text": {
"type": "string",
"description": "The quoted tweet's own caption text (unlike the top-level tweet's own text, which is withheld -- see this schema's top-level description)."
},
"media": {
"type": "object",
"properties": {
"photo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"media_url_https": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"views": {
"type": "string"
},
"author": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"avatar": {
"type": [
"string",
"null"
]
},
"rest_id": {
"type": "string"
},
"screen_name": {
"type": "string"
},
"blue_verified": {
"type": "boolean"
}
},
"description": "The quoted tweet's own author -- a different account from the queried user.",
"additionalProperties": true
},
"quotes": {
"type": "number"
},
"replies": {
"type": "number"
},
"retweets": {
"type": "number"
},
"tweet_id": {
"type": "string"
},
"bookmarks": {
"type": "number"
},
"favorites": {
"type": "number"
},
"sensitive": {
"type": [
"boolean",
"null"
],
"description": "Observed false on most quoted tweets and null on one."
},
"created_at": {
"type": "string"
},
"conversation_id": {
"type": "string"
}
},
"description": "Present only when this tweet quotes another tweet. The quoted tweet's author is a DIFFERENT, independent public Twitter account, not the queried user -- seen e.g. for elonmusk.",
"additionalProperties": true
},
"quotes": {
"type": "number"
},
"source": {
"type": [
"string",
"null"
],
"description": "The posting client, as an HTML anchor tag, e.g. 'Twitter for iPhone'; null when the provider omits it."
},
"replies": {
"type": "number"
},
"reply_to": {
"type": "string",
"description": "Present only when this tweet is a reply; the parent tweet's id."
},
"retweets": {
"type": "number"
},
"tweet_id": {
"type": "string"
},
"bookmarks": {
"type": "number"
},
"favorites": {
"type": "number"
},
"sensitive": {
"type": "boolean"
},
"created_at": {
"type": "string",
"description": "Twitter's native date format, e.g. 'Fri Sep 04 18:29:34 +0000 2026'."
},
"conversation_id": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "The queried account's tweets that include media, most recent first."
},
"next_cursor": {
"type": "string",
"description": "Pagination cursor for the next page of media tweets."
}
},
"description": "The media-timeline record.",
"additionalProperties": true
}