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
NodeJS
$ curl https://tweetpik.com/api/v2/images \
--header "Content-Type: application/json" \
--header "Authorization: your-api-key" \
--request POST \
--data '{"url":"https://twitter.com/bruno__quaresma/status/1370397279279054848"}'

Authentication

To access the API, you need to pass your API key directly in the Authorization header. You can find your API key in the dashboard.

Screenshoting a tweet image

To screenshot a tweet, you must pass the url attribute in the body, this url, is the tweet URL. The response also returns a url field which is the image URL for the screenshotted tweet. This image, is only available for 24 hours after the request so you must save or store the image in your own server after that.

Customization

You can use some extra options to customize your image. These options should be used together with the url in the request body.

OptionValuesDescription
themeA custom theme ID or one of the following default themes IDs:
  • default
  • dim
  • lightsOut
Default is default
You can use a theme instead of pass all the customization values trough the API. You can find all your themes and their IDs in the dashboard.
dimension
  • instagramFeed - 1080px - 1080px
  • instagramStories - 1080px - 1920px
  • instagramFeedVertical - 1080px - 1350px
  • tiktok - 1080px - 1920px
  • linkedInPost - 1200px - 627px
  • autoHeight - 1080px - auto
Default is instagramFeed
Change the image dimension
textPrimaryColorAny valid hexa - #000 or rgb - rgb(0,0,0) color. The default is the one defined in the defaultTwitterTheme theme.Change the text primary color used for the main text of the tweet and user name
textSecondaryColorAny valid hexa - #000 or rgb - rgb(0,0,0) color. The default is the one defined in the defaultTwitterTheme theme.Change the text secondary used for the secondary info of the tweet like the username
linkColorAny valid hexa - #000 or rgb - rgb(0,0,0) color. The default is the one defined in the defaultTwitterTheme theme.Change the link colors used for the links, hashtags and mentions
verifiedIconColorAny valid hexa - #000 or rgb - rgb(0,0,0) color. The default is the one defined in the defaultTwitterTheme theme.Change the verified icon color
backgroundColorAny valid hexa - #000 or rgb - rgb(0,0,0) color. The default is the one defined in the defaultTwitterTheme theme.Change the background color of the tweet screenshot
backgroundImageA valid HTTP or HTTPS URLA 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
displayMetricstrue or false. Default is falseDisplay the tweet engagement metrics
displayVerified
  • auto - Display the verified icon if user is verified
  • true - Always display the verified icon
  • false - Never display the verified icon
Default is default
Display the verified icon
displayEmbedstrue or false. Default is trueDisplay images, video or link previews present in the tweet
contentWidthAny number higher than zero. This value is representing a percentageThe horizontal width of tweet content

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.

Adam Durrant profile image
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!
Adam Durrant -
Maker of seotweets.io

Get all the PRO features

Fully professional and customized images

Pro plan isn't maintained any longer. Please check TweetHunter instead