Credits

How Credits Work

ScreenshotAPI uses a simple credit-based pricing model:

• 1 screenshot = 1 credit
• Credits are deducted only for successful screenshots
• Failed requests are never charged
• Credits never expire
• New accounts receive 5 free credits

This means you only pay for what you use — no monthly subscriptions, no overage fees, and no wasted spend.

Checking Your Balance

curl "https://screenshotapi.to/api/v1/credits" \
  --cookie "session=your_session_cookie"

const response = await fetch('https://screenshotapi.to/api/v1/credits', {
  credentials: 'include'
})

const { balance } = await response.json()
console.log(`Remaining credits: ${balance}`)

import requests

response = requests.get(
    "https://screenshotapi.to/api/v1/credits",
    cookies={"session": "your_session_cookie"}
)

balance = response.json()["balance"]
print(f"Remaining credits: {balance}")

Your credit balance is also returned in the x-credits-remaining response header after every screenshot request, so you can track your balance without making a separate API call.

Credit Packs

Purchase credits in pre-configured packs. View available packs:

curl "https://screenshotapi.to/api/v1/credits/packs"

[
  {
    "id": "pack_starter",
    "name": "Starter",
    "credits": 100,
    "priceCents": 500,
    "isPopular": false
  },
  {
    "id": "pack_pro",
    "name": "Pro",
    "credits": 1000,
    "priceCents": 3500,
    "isPopular": true
  },
  {
    "id": "pack_business",
    "name": "Business",
    "credits": 5000,
    "priceCents": 12500,
    "isPopular": false
  },
  {
    "id": "pack_enterprise",
    "name": "Enterprise",
    "credits": 25000,
    "priceCents": 50000,
    "isPopular": false
  }
]

The /credits/packs endpoint is public and does not require authentication.

Purchasing Credits

To purchase a credit pack, send the pack ID. You'll receive a Polar checkout URL:

curl -X POST "https://screenshotapi.to/api/v1/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{"packId": "pack_pro"}' \
  --cookie "session=your_session_cookie"

const response = await fetch('https://screenshotapi.to/api/v1/credits/purchase', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({ packId: 'pack_pro' })
})

const { checkoutUrl } = await response.json()
// Redirect user to checkoutUrl to complete payment
window.location.href = checkoutUrl

import requests

response = requests.post(
    "https://screenshotapi.to/api/v1/credits/purchase",
    json={"packId": "pack_pro"},
    cookies={"session": "your_session_cookie"}
)

checkout_url = response.json()["checkoutUrl"]
# Redirect user to checkout_url to complete payment

After successful payment through Polar, credits are automatically added to your account via webhooks.

Transaction History

View your credit transaction history:

curl "https://screenshotapi.to/api/v1/credits/transactions?limit=10&offset=0" \
  --cookie "session=your_session_cookie"

Each transaction shows the type (purchase, auto_topup, usage, signup_bonus), amount, description, and timestamp.

Auto Top-Up

Configure credit balance monitoring from your dashboard. When your balance drops below a threshold you set, you'll be prompted to purchase more credits.

How it works:

1. Set a threshold (e.g., 50 credits).
2. Choose a credit pack to suggest (e.g., Pro pack with 1,000 credits).
3. When your balance drops below 50, you'll see a prompt to buy more credits.

You can enable, disable, or reconfigure auto top-up at any time from the settings page.

Insufficient Credits

If you attempt a screenshot request with zero credits, you'll receive a 402 response:

{
  "error": "Insufficient credits",
  "balance": 0,
  "message": "Purchase more credits at screenshotapi.to/dashboard/credits"
}

The request is not processed and no credit is deducted.

Pricing Summary

Higher-volume packs offer a lower cost per credit. All prices are in USD and exclude applicable taxes.