Pass an array of up to 9 tweet URLs to /v1/wall and get back a single composited PNG — every card laid out in a clean grid, ready to embed anywhere.
No layout code, no gluing images together. One request, one asset, structured JSON metadata included.
View wall docs →
POST to /v1/card with any public tweet URL and your API key. Works with X/Twitter today; more platforms coming.
We pull the tweet data, render a pixel-perfect card at 1200×630 using your chosen theme, and upload it to our CDN.
The response includes a permanent CDN URL for the image plus structured metadata — quote, author, likes, reposts.
Base URL: https://api.proofshot.dev
Single card · 1200×630px
curl -X POST https://api.proofshot.dev/v1/card \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"url": "https://x.com/user/status/123",
"theme": "light"
}'{
"card_url": "https://cdn.proofshot.dev/cards/abc123.png",
"width": 1200,
"height": 630,
"source": "twitter",
"quote": "The first principle is that you must not fool yourself…",
"author_name": "Prof. Feynman",
"author_handle": "@ProfFeynman",
"likes": 48291,
"reposts": 8104,
"credits_used": 1
}Authenticate every request with x-api-key: YOUR_API_KEY. Get your key from the account page.
1 credit = 1 card or 1 wall (regardless of how many URLs are in the wall).
Free to sign up — no card required. Credits added on payment confirmation.