media_extraction_helper
Extracts direct media URLs from a tweet, including images, videos, and animated GIFs. Returns URLs with dimensions, bit rates, and content types for further processing.
Instructions
Extracts direct media URLs (images, videos, animated GIFs) from a tweet. Use this tool when the LLM needs to access media content from a tweet—for example, to view an attached image, download a video, analyze media metadata, or pass media URLs to other tools. For photos, returns the direct image URL. For videos and animated GIFs, returns all available variants with direct URLs, bit rates, and content types. The highest bitrate MP4 variant is typically the best quality video. Returns the tweet ID, media array with type/URL/dimensions/duration, and total media count.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tweet_id | Yes | The unique numeric string ID of the tweet to extract media from. The tool will fetch the tweet with media expansions and return direct URLs for all attached images, videos, and animated GIFs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Indicates the outcome of the operation: "success" or "error". | |
| message | Yes | A human-readable summary of the result. | |
| data | Yes | Container holding the extracted media URLs and metadata. |