Skip to main content
TwitterShots logo
  • Category: images & design
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: TWITTERSHOTS
  • Version: 00000000_00

Tools

Slug: TWITTERSHOTS_GENERATE_TEMPORARY_SCREENSHOT_URLRender 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 displayed on the rendered post.
string ("light" | "dark")
Light or dark tweet color theme.
integer
Tweet content-area width in pixels (300-1000).
string ("svg" | "png" | "html")
Hosted render format. SVG is verified; PNG and HTML are documented but unverified.
string
Tweet content-area height in pixels, or ‘auto’ to fit the content.
string
required
Numeric tweet/status ID or full public tweet/post status URL.
boolean
Render attached images and videos.
boolean
Show reply, repost, and like counts.
boolean
Show the view count.
string ("auto" | "1:1" | "4:5" | "5:4" | "16:9" | "9:16")
Output canvas aspect ratio.
string ("grid" | "vertical")
Layout for attached media.
number
Container border radius in pixels.
boolean
Show the full post instead of a collapsed ‘Show more’ state.
boolean
Show the post timestamp.
string
Optional HTTPS URL of a background image.
string
Fixed UTC offset for the timestamp, such as UTC-5, UTC+8, or UTC+5:30.
number
Container padding in pixels.
string
Optional container background as a hex color, rgba() color, or linear-gradient() value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWITTERSHOTS_GENERATE_TWEET_SCREENSHOTRender a public tweet or post as an SVG, PNG, or HTML file suitable for saving. A successful render consumes one API credit.

Input Parameters

string ("x" | "bluebird" | "none")
Logo displayed on the rendered post.
string ("light" | "dark")
Light or dark tweet color theme.
integer
Tweet content-area width in pixels (300-1000).
string ("svg" | "png" | "html")
File format for the rendered output. SVG is live-verified; PNG and HTML are documented.
string
Tweet content-area height in pixels, or ‘auto’ to fit the content.
string
required
Numeric tweet/status ID or full public tweet/post status URL.
boolean
Render attached images and videos.
boolean
Show reply, repost, and like counts.
boolean
Show the view count.
string ("auto" | "1:1" | "4:5" | "5:4" | "16:9" | "9:16")
Output canvas aspect ratio.
string ("grid" | "vertical")
Layout for attached media.
number
Container border radius in pixels.
boolean
Show the full post instead of a collapsed ‘Show more’ state.
boolean
Show the post timestamp.
string
Optional HTTPS URL of a background image.
string
Fixed UTC offset for the timestamp, such as UTC-5, UTC+8, or UTC+5:30.
number
Container padding in pixels.
string
Optional container background as a hex color, rgba() color, or linear-gradient() value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWITTERSHOTS_GET_API_USAGEReturn the remaining and total TwitterShots API credits for the connected API key. This read does not consume a credit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWITTERSHOTS_GET_BULK_TWEET_CONTENTFetch 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

array
required
Numeric IDs of 1-100 public tweets to fetch in one request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWITTERSHOTS_GET_TWEET_CONTENTFetch one public tweet as structured Markdown, with optional statistics, media links, and quoted-tweet content. A successful call consumes one API credit.

Input Parameters

string
required
Numeric ID of the public tweet to fetch.
boolean
Include image and video URLs in the Markdown.
boolean
Include reply, repost, like, and view counts in the Markdown.
boolean
Include quoted-tweet content when present.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not