API Changelog
API version updates for the Tweet Screenshot API.
v0.9.1Article supportLatest
0xinhua- 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
0xinhua- 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,urlreturns JSON with image URL. Note: URL storage will be removed in the future due to CDN and DMCA costs; usebufferand store images on your own side
v0.8.3Japanese & media layout
0xinhua- Added Japanese font support for Japanese tweet screenshots
- Added mediaLayout parameter:
grid|verticalfor media display layout
v0.8.2Japanese fix & showMedia
0xinhua- Fixed Japanese tweet screenshot rendering issue
- Added showMedia parameter to control images/videos in tweet (default: true, optional)
v0.8.1Custom width & height
0xinhua- 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
0xinhua- 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
0xinhua- 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.
v0.6.0Borders & aspect ratio
0xinhua- 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
0xinhua- 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
0xinhua- 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
0xinhua- 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
0xinhua- 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
0xinhua- 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.