Tweet Screenshot Tool with API — Docs & Examples
5 min read
Tweet Screenshot Tool with API: TL;DR
- What it does TwitterShots turns a tweet ID into PNG, SVG, or HTML via one authenticated GET request — no Twitter/X API key required.
- Auth X-API-KEY header from twittershots.com/settings/keys.
- Limits credit-based — Free 50 one-time, Pro 300/mo, Pro+ 1,000/mo, Business 6,000/mo.
- Agents & automation works with curl, Node, Zapier, n8n, Make, and MCP / Agent Skills.
TwitterShots is a tweet screenshot tool with an API: send a tweet ID with your API key, get a rendered PNG, SVG, or HTML image back. You do not need a Twitter/X developer account — TwitterShots fetches and renders the post for you.
curl 'https://api.twittershots.com/api/v1/screenshot/1981415642981888505?format=png&theme=light' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Accept: image/png' \
-o tweet.png
const res = await fetch(
'https://api.twittershots.com/api/v1/screenshot/1981415642981888505?format=png&theme=light',
{ headers: { 'X-API-KEY': process.env.TWITTERSHOTS_API_KEY } }
);
const buffer = Buffer.from(await res.arrayBuffer());
Full reference: API docs · machine-readable: OpenAPI · discovery: api-catalog
Auth, Limits, Formats, Pricing
| Item | Details |
|---|---|
| Auth | X-API-KEY header (get a key) |
| Endpoint | GET https://api.twittershots.com/api/v1/screenshot/{tweetId} |
| Formats | png, svg (default), html |
| Themes | light, dark |
| Response | Image bytes (returnType=buffer, default) or JSON URL (returnType=url) |
| Quota headers | X-Quota-Remaining, X-Quota-Limit |
| Free | 50 one-time API credits |
| Pro | ~$5.83/mo (yearly) · 300 credits/mo |
| Pro+ | ~$10.83/mo (yearly) · 1,000 credits/mo |
| Business | $49/mo · 6,000 credits/mo |
Product landing: tweet-screenshot-api.
Common Automated Workflows
| Workflow | How |
|---|---|
| Newsletter roundup | Cron or CMS hook → screenshot API → embed PNGs in the issue |
| Zapier / Make / n8n | Official integrations at /integrations |
| AI agents | Call the same GET from Cursor/Claude via Agent Skill or MCP |
| Bulk archive | Batch up to 30 tweet IDs per request (paid plans) |
Does This Need a Twitter/X API Key?
No. You only need a TwitterShots API key. The service resolves public tweet data and returns the image — developers do not apply for X API access for this workflow.
Frequently asked questions
- Does this tweet screenshot tool work without a Twitter/X API key?
- Yes. Authenticate with a TwitterShots X-API-KEY only. You do not need Twitter/X developer credentials to generate screenshots.
- What is the rate limit for the TwitterShots screenshot API?
- Usage is credit-based, not a fixed requests-per-minute cap. Free includes 50 one-time credits; Pro 300/mo, Pro+ 1,000/mo, Business 6,000/mo. Remaining quota is returned in X-Quota-Remaining and X-Quota-Limit headers.
- Can AI agents call this API directly?
- Yes. Any agent that can send HTTP GET with an X-API-KEY header can call it. Use the OpenAPI file at /openapi.yaml, the Agent Skill at /agents, or the MCP server for tool-calling environments.
- What output formats does the API return?
- PNG, SVG, and HTML. Use format=png for social posts, format=svg for vector/web, format=html for custom rendering pipelines.
Get 50 Free API Credits
Create a key and screenshot your first tweet with one GET request. No Twitter/X API key required.
- GET /screenshot/{tweetId}
- PNG · SVG · HTML
- X-API-KEY auth
- Zapier / n8n / Make
- OpenAPI + MCP
- 50 free credits