The easiest way for
developers and businesses
to take Twitter screenshots
Taking a screenshot of Twitter using the API is very simple.
You can see some examples below using cURL or NodeJS.
$ curl https://tweetpik.com/api/images \
--header "Content-Type: application/json" \
--header "Authorization: your-api-key" \
--request POST \
--data '{"tweetId":"1370397279279054848"}'Authentication
To access the API, you need to pass your API key in the authorization header. You will see how to use this correctly in the next section.
Integrations
TweetPik can be easily integrated with Zapier and Integromat. We have a blog post showing how to publish tweets to Instagram using TweetPik and Zapier.
Screenshoting a tweet image
To screenshot a tweet, you must pass the tweetId in the body.
Response
The response will return the url attribute you can use to load your image and apply transformations for optimization.
Options
You can use some extra options to customize your image. These options should be used together with the tweetId in the response body.
| Option | Values | Description |
|---|---|---|
| themeId New | The theme ID. Default is null | You can use a theme instead of pass all the customization values trough the API |
| dimension |
| Change the image dimension |
| timezone New | See the supported timezone list on this Wikipedia page. Default is America/Chicago. | Helpful when you want to display the time in an specific timezone. |
| displayLikes | true or false. Default is false | Includes the number of likes until that exactly moment |
| displayReplies | true or false. Default is false | Includes the number of replies until that exactly moment |
| displayRetweets | true or false. Default is false | Includes the number of retweets until that exactly moment |
| displayVerified | true or false. If the user is verfied, the default is true | Includes the verified badge |
| displaySource | true or false. Default is true | Includes the source of the tweet |
| displayTime | true or false. Default is true | Includes the time of the tweet |
| displayMediaImages New | true or false. Default is true | Includes the tweet media images |
| displayLinkPreview New | true or false. Default is true | Includes the link preview image and info |
| textWidth | Any number higher than zero. This value is representing a percentage | The horizontal width of tweet text |
| canvasWidth New | Any number higher than zero. This value is used in pixels(px) units | The horizontal width of the image |
| backgroundImage | A valid URL | A image that you want to use as background. You need to use this as a valid URL like https://mysite.com/image.png and it should not be protected by CORS |
| logoImage | A valid URL | A image that you want to use as logo. You need to use this as a valid URL like https://mysite.com/logo.png and it should not be protected by CORS |
| logoWidth | Any number higher than zero. This value is representing the width in pixels | The horizontal width of the logo image |
Color options
You can also use some options to customize your tweet screenshot. The color values can be on hexa - #000 or rgb - rgb(0,0,0) format. The following options should be added inside of the colors attribute
| Option | Description |
|---|---|
| backgroundColor | Change the background color of the tweet screenshot |
| textPrimaryColor | Change the text primary color used for the main text of the tweet and user‘s name |
| textSecondaryColor | Change the text secondary used for the secondary info of the tweet like the username |
| linkColor | Change the link colors used for the links, hashtags and mentions |
| verifiedIcon | Change the verified icon color |
Building the URL
The URL is predictable, so you don‘t have to worry about storing it. You just need to make sure you generated it before using it. The URL will always consist of your bucket ID and the tweet ID.https://ik.imagekit.io/tweetpik/<bucket-id>/tweetId
Taking Branded Twitter Screenshots
We want to make sure your branded tweet shots are as attractive as possible. As such, we’ve created this guide to help you get the most out of your branded tweet shots.
Publishing tweets to Instagram using TweetPik and Zapier
Learn how to publish tweets to Instagram automatically. TweetPik helps you to automate all of that using Zapier in just a few steps.
Screenshot A Tweet and Turn It Into A Video To Post On Your Social
It is very usual to see users on TikTok and Instagram turn tweets into videos. Helpfully TweetPik can help you with that.
Screenshot A Tweet Using A Custom Theme In The TweetPik API
Learn how to automatically take professional tweet screenshots using custom themes with the TweetPik API in just a few steps.
For a fun project I wanted to help the SEO community by curating tweets from the best and brightest in the industry. Looking for a solution to help with that, I came across TweetPik. After digging into the API and exploring the effortless Zapier integration, I knew it was a contender. After reaching out to Bruno, I quickly learned how kind, generous and talented he was as a developer. I knew at that point tweetpik was the perfect solution. I now use tweetpik every day to automate my curation tool seotweets.io which shares pixel perfect screenshots straight from tweetpik into my CMS - all I have to do is “like“ a tweet!