Developer API

Turn social proof
into instant assets.

Send a tweet URL. Get back a beautifully styled PNG card and structured JSON — ready to embed anywhere in one API call.

Get API key →View docs
1 credit
per card or wall
< 5s
average render time
1200×630
PNG output
LIVE DEMO

Paste any tweet URL and hit enter. 2 free requests/day.

Wall API

Embed a full social proof wall — one call.

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 →
Wall of Love grid — three social proof cards side by side
Used by teams at
How it works

Three steps to a production-ready card

01

Send a tweet URL

POST to /v1/card with any public tweet URL and your API key. Works with X/Twitter today; more platforms coming.

02

We fetch and render

We pull the tweet data, render a pixel-perfect card at 1200×630 using your chosen theme, and upload it to our CDN.

03

Get a hosted PNG + JSON

The response includes a permanent CDN URL for the image plus structured metadata — quote, author, likes, reposts.

API Reference

Two endpoints. That's it.

Base URL: https://api.proofshot.dev

Single card · 1200×630px

Request
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"
  }'
Response
{
  "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.

Pricing

Simple, credit-based pricing

1 credit = 1 card or 1 wall (regardless of how many URLs are in the wall).

Free
£0 one-time
50 credits
  • 50 cards or walls
  • 1200×630 PNG
  • Hosted CDN URL
  • JSON metadata
Starter
£9/mo
500 credits
  • 500 cards or walls/mo
  • 1200×630 PNG
  • Hosted CDN URL
  • JSON metadata
Most popular
Pro
£29/mo
2,500 credits
  • 2,500 cards or walls/mo
  • 1200×630 PNG
  • Hosted CDN URL
  • JSON metadata
  • Priority support
Scale
£79/mo
10,000 credits
  • 10,000 cards or walls/mo
  • 1200×630 PNG
  • Hosted CDN URL
  • JSON metadata
  • Priority support
Top-up
£7 one-time
+500 credits
  • Add 500 credits any time
  • No subscription needed
  • Never expire

Free to sign up — no card required. Credits added on payment confirmation.