# API Changelog

API version updates for the Tweet Screenshot API.

## v0.9.1Article supportLatest

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Apr 14, 2026

- **X articles** supported in the TwitterShots API: generate screenshots for X / Twitter article URLs and article-style posts, not only single tweets.

## v0.8.4Timezone & return type

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Mar 24, 2026

- Added **timeZoneOffset** parameter for formatting tweet timestamps with fixed UTC offset (e.g. `UTC+8`, `UTC-5`)
- Improved **returnType** parameter: `buffer` (default) returns image directly, `url` returns JSON with image URL. Note: URL storage will be removed in the future due to CDN and DMCA costs; use `buffer` and store images on your own side

## v0.8.3Japanese & media layout

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Feb 22, 2026

- Added Japanese font support for Japanese tweet screenshots
- Added **mediaLayout** parameter: `grid` | `vertical` for media display layout

## v0.8.2Japanese fix & showMedia

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Feb 19, 2026

- Fixed Japanese tweet screenshot rendering issue
- Added **showMedia** parameter to control images/videos in tweet (default: true, optional)

## v0.8.1Custom width & height

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jan 26, 2026

- Added **width** parameter for customizing tweet content area width (default: 410px, range: 300-1000px)
- Added **height** parameter for customizing tweet content area height (default: auto, adapts to content)
- Added concise logging for API requests

## v0.8.0Quota headers

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jan 23, 2026

- Fixed Tweet screenshot timestamp format in API response
- Added **X-Quota-Remaining** response header for tracking remaining API calls
- Added **X-Quota-Limit** response header for total quota limit
- Added email notifications at 50%, 70%, 90%, and 100% usage thresholds

## v0.7.0Storage URL & backgrounds

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jan 3, 2026

- Added **returnType** parameter support for returning the storage URL of the uploaded image
- Added support for customizable gradient background colors
- Added background image support for tweet screenshot background
- See the [full parameter list here](https://twittershots.com/docs/api#param-background-image).

## v0.6.0Borders & aspect ratio

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Dec 29, 2025

- Added border color customization parameter for screenshot borders
- Added shadow customization parameter
- Added background color support for custom background styling
- Added aspect ratio parameter for flexible image dimensions

## v0.5.0Retweets & URL input

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Oct 20, 2025

- Fixed retweet display and styling issues
- Added URL support for tweet input (accepts both tweet IDs and URLs)
- Updated Satori rendering engine to v0.18.3 for better performance
- Fixed avatar API endpoints and verification badge rendering
- Enhanced user verification type support (verified, business, government badges)
- Improved link preview card display and formatting
- Fixed emoji rendering and text encoding issues
- Improved error handling, logging, and API message formatting
- Fixed avatar border radius and styling consistency
- Enhanced language support and locale handling

## v0.4.0Views & quoted tweets

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jul 22, 2025

- Added showViews parameter to control view count display
- Added showTimestamp parameter to toggle timestamp visibility
- Fixed quoted tweet rendering with proper indentation and media support
- Enhanced user verification type support for different badge types
- Improved link preview card display and styling
- Fixed showStats parameter behavior and consistency

## v0.3.0Logo & themes

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jul 19, 2025

- Added logo parameter with options: x, bluebird, or none
- Fixed text formatting, wrapping, and line breaks
- Improved emoji rendering and Unicode support
- Enhanced theme support (light/dark mode consistency)
- Fixed text limit handling and truncation

## v0.2.0Full text & stats

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jul 13, 2025

- Added showFullText parameter to control long tweet expansion
- Added showStats parameter to toggle engagement metrics display
- Improved text wrapping and formatting algorithms
- Fixed text limit handling for long tweets

## v0.1.0First release

![](https://twittershots.com/changelog/twittershots-github-avatar.png)0xinhua·Jul 10, 2025

- Initial API release - First public version of TwitterShots Screenshot API
- Image format support: SVG (vector) and PNG (raster) output formats
- Theme options: Light and dark mode support for screenshots
- RESTful API endpoint with simple GET request interface
- Basic tweet data fetching and tweet screenshot generation
- API key authentication system

For more details about the API, visit the [API Documentation](/docs/api).