Skip to content

Monthly usage and limit ​

Every account can make a number of API requests per calendar month.

Your monthly limit ​

Every account gets 100 free requests per month, with or without a plan. A plan adds its requests on top. Accounts without a plan or credits also have lower option limits, see Free plan.

PlanRequests per month
No plan100
Small2,100
Base10,100
Plus25,100
Medium50,100
Large100,100

Screenshots, PDFs and rendered HTML all count the same: one request each.

Which requests count ​

  • Requests that return a screenshot, PDF or rendered HTML count.
  • Requests that fail while rendering or time out (400) also count, because the browser already ran.
  • Captures through the MCP server count like API requests.
  • Results from the cache don't count.
  • Retries with the same X-Request-ID that return the stored response don't count.
  • Requests that fail validation (422) or hit a rate limit (429) don't count.
  • Test requests don't count.

When you reach the limit ​

Once your monthly requests are used up, each further request uses one credit. Without credits, the API returns a 402 error until the next month starts:

json
{
    "message": "The monthly API usage limit has been reached (100 out of 100 requests) and there are no credits left. Upgrade your plan or buy credits under https://3.screeenly.com/app/billing/credits. The limit resets at the start of next month."
}

We email you when you've used 75%, 90% and 100% of your monthly requests.

When the usage resets ​

The usage resets at 00:00 UTC on the first day of each month. Credits don't reset.

Where to see your usage ​

  • On the dashboard and the billing page in the app.
  • In the response headers of every API request:
HeaderDescription
X-Usage-LimitYour monthly limit.
X-Usage-UsageRequests made this month.
X-Usage-RemainingRequests left this month.
X-Usage-ResetsWhen the usage resets, as an ISO 8601 date.
X-Credits-RemainingYour credit balance.
  • In the meta.usage_limit object of successful responses:
json
{
    "meta": {
        "usage_limit": {
            "limit": 2100,
            "usage": 15,
            "remaining": 2085,
            "resets": "2026-12-01T00:00:00+00:00"
        }
    }
}