Guide

Get your first styled screenshot in 5 minutes

Sign up, grab an API key, and make your first API call. No SDK needed — it's just a POST request.

Step 1 — Create an account

  • Sign up at screenframed.com/signup. No credit card required. You get 200 free credits per month on the Hobby plan.

Step 2 — Get your API key

  • Go to Dashboard → API Keys and generate a live key. It starts with sf_live_. For testing, generate a test key (sf_test_) — it returns real renders but charges zero credits.

Step 3 — Make your first API call

  • Send a POST request to /v1/capture with a URL and any styling parameters. The API returns a CDN URL to your rendered image.

Minimal example

Auto-balance, no styling params

curl -X POST https://screenframed.com/v1/capture \
  -H "Authorization: Bearer sf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://stripe.com"}'

With styling

Ocean gradient, browser frame

curl -X POST https://screenframed.com/v1/capture \
  -H "Authorization: Bearer sf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "background_preset": "ocean",
    "shadow": "soft",
    "padding": 60,
    "corner_radius": 12,
    "device": "browser-macos"
  }'

With a device frame

MacBook Pro frame

curl -X POST https://screenframed.com/v1/capture \
  -H "Authorization: Bearer sf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "device": "macbook-pro-16",
    "background_preset": "midnight",
    "shadow": "float",
    "padding": 80
  }'

Let AI decide everything

curl -X POST https://screenframed.com/v1/capture \
  -H "Authorization: Bearer sf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "ai": true
  }'