Skip to content
Eden Engine

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 callv1
Provider
Web & Business Data Network
Category
twitter
Provider price
$0.0020475 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

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.json
{
  "type": "object",
  "properties": {
    "user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "description": "'active' on both real calibration calls."
        },
        "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 (observed on the jack fixture)."
        },
        "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": "Observed only on the elonmusk fixture."
                }
              },
              "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": "'ok' on both real calibration calls."
    },
    "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": "Observed only in the elonmusk fixture."
              }
            },
            "description": "Present with a `photo` and/or `video` array when the tweet carries media; observed as an empty array `[]` on non-media tweets in the jack fixture.",
            "additionalProperties": true
          },
          "views": {
            "type": "string",
            "description": "Numeric string, e.g. '12531622'."
          },
          "author": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "avatar": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Observed null on every real timeline entry across both fixtures."
              },
              "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 -- observed in the elonmusk fixture only.",
            "additionalProperties": true
          },
          "quotes": {
            "type": "number"
          },
          "source": {
            "type": "string",
            "description": "The posting client, as an HTML anchor tag, e.g. 'Twitter for iPhone'."
          },
          "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, as returned at routing.responseResultPath ($.output).",
  "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.

ChargeRate
Per call
Flat, regardless of what comes back
$0.0020475
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 15, 2026