> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TwitterShots

> TwitterShots renders public X posts as screenshots and retrieves tweet content and API usage.

![TwitterShots logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/twittershots.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=863988a46c8361d7768e5b56f1494a47)

* **Category:** images & design
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `TWITTERSHOTS`
* **Version:** 00000000\_00

## Tools

> [accordion] Generate Temporary Screenshot URL
>
> **Slug:** `TWITTERSHOTS_GENERATE_TEMPORARY_SCREENSHOT_URL`
>
> Render a public tweet or post and return a provider-hosted temporary URL. Download the result promptly or use Generate Tweet Screenshot when it must be retained. A successful render consumes one API credit.
>
> #### Input Parameters
>
> **logo** `string ("x" | "bluebird" | "none")`
>
> Logo displayed on the rendered post.
>
> **theme** `string ("light" | "dark")`
>
> Light or dark tweet color theme.
>
> **width** `integer`
>
> Tweet content-area width in pixels (300-1000).
>
> **format** `string ("svg" | "png" | "html")`
>
> Hosted render format. SVG is verified; PNG and HTML are documented but unverified.
>
> **height** `string`
>
> Tweet content-area height in pixels, or 'auto' to fit the content.
>
> **tweet\_id** `string` *required*
>
> Numeric tweet/status ID or full public tweet/post status URL.
>
> **show\_media** `boolean`
>
> Render attached images and videos.
>
> **show\_stats** `boolean`
>
> Show reply, repost, and like counts.
>
> **show\_views** `boolean`
>
> Show the view count.
>
> **aspect\_ratio** `string ("auto" | "1:1" | "4:5" | "5:4" | "16:9" | "9:16")`
>
> Output canvas aspect ratio.
>
> **media\_layout** `string ("grid" | "vertical")`
>
> Layout for attached media.
>
> **border\_radius** `number`
>
> Container border radius in pixels.
>
> **show\_full\_text** `boolean`
>
> Show the full post instead of a collapsed 'Show more' state.
>
> **show\_timestamp** `boolean`
>
> Show the post timestamp.
>
> **background\_image** `string`
>
> Optional HTTPS URL of a background image.
>
> **time\_zone\_offset** `string`
>
> Fixed UTC offset for the timestamp, such as UTC-5, UTC+8, or UTC+5:30.
>
> **container\_padding** `number`
>
> Container padding in pixels.
>
> **container\_background** `string`
>
> Optional container background as a hex color, rgba() color, or linear-gradient() value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Tweet Screenshot
>
> **Slug:** `TWITTERSHOTS_GENERATE_TWEET_SCREENSHOT`
>
> Render a public tweet or post as an SVG, PNG, or HTML file suitable for saving. A successful render consumes one API credit.
>
> #### Input Parameters
>
> **logo** `string ("x" | "bluebird" | "none")`
>
> Logo displayed on the rendered post.
>
> **theme** `string ("light" | "dark")`
>
> Light or dark tweet color theme.
>
> **width** `integer`
>
> Tweet content-area width in pixels (300-1000).
>
> **format** `string ("svg" | "png" | "html")`
>
> File format for the rendered output. SVG is live-verified; PNG and HTML are documented.
>
> **height** `string`
>
> Tweet content-area height in pixels, or 'auto' to fit the content.
>
> **tweet\_id** `string` *required*
>
> Numeric tweet/status ID or full public tweet/post status URL.
>
> **show\_media** `boolean`
>
> Render attached images and videos.
>
> **show\_stats** `boolean`
>
> Show reply, repost, and like counts.
>
> **show\_views** `boolean`
>
> Show the view count.
>
> **aspect\_ratio** `string ("auto" | "1:1" | "4:5" | "5:4" | "16:9" | "9:16")`
>
> Output canvas aspect ratio.
>
> **media\_layout** `string ("grid" | "vertical")`
>
> Layout for attached media.
>
> **border\_radius** `number`
>
> Container border radius in pixels.
>
> **show\_full\_text** `boolean`
>
> Show the full post instead of a collapsed 'Show more' state.
>
> **show\_timestamp** `boolean`
>
> Show the post timestamp.
>
> **background\_image** `string`
>
> Optional HTTPS URL of a background image.
>
> **time\_zone\_offset** `string`
>
> Fixed UTC offset for the timestamp, such as UTC-5, UTC+8, or UTC+5:30.
>
> **container\_padding** `number`
>
> Container padding in pixels.
>
> **container\_background** `string`
>
> Optional container background as a hex color, rgba() color, or linear-gradient() value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get API Usage
>
> **Slug:** `TWITTERSHOTS_GET_API_USAGE`
>
> Return the remaining and total TwitterShots API credits for the connected API key. This read does not consume a credit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bulk Tweet Content
>
> **Slug:** `TWITTERSHOTS_GET_BULK_TWEET_CONTENT`
>
> Fetch up to 100 public tweets as one Markdown document. Inspect the returned Markdown for a 'Failed to fetch tweets' section because individual IDs can fail within an HTTP 200 response. A successful bulk request consumes one API credit.
>
> #### Input Parameters
>
> **tweet\_ids** `array` *required*
>
> Numeric IDs of 1-100 public tweets to fetch in one request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tweet Content
>
> **Slug:** `TWITTERSHOTS_GET_TWEET_CONTENT`
>
> Fetch one public tweet as structured Markdown, with optional statistics, media links, and quoted-tweet content. A successful call consumes one API credit.
>
> #### Input Parameters
>
> **tweet\_id** `string` *required*
>
> Numeric ID of the public tweet to fetch.
>
> **include\_media** `boolean`
>
> Include image and video URLs in the Markdown.
>
> **include\_stats** `boolean`
>
> Include reply, repost, like, and view counts in the Markdown.
>
> **include\_quoted** `boolean`
>
> Include quoted-tweet content when present.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
