Usage

Check your credit balance and usage history for the current billing period.

GET/api/v1/usage

Response Schema

periodobject

Current billing period

startstring

Period start (ISO 8601)

endstring

Period end (ISO 8601)

creditsUsednumber

Credits consumed this period

creditsLimitnumber

Plan credit limit

creditsRemainingnumber

Plan credits remaining

purchasedCreditsnumber

Extra purchased credits

totalRemainingnumber

Plan + purchased credits remaining

requestsnumber

Total requests this period

Request

curl https://scraper.run/api/v1/usage \
  -H "Authorization: Bearer sc_live_..."

Response Example

{
  "period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-04-01T00:00:00Z"
  },
  "creditsUsed": 1250,
  "creditsLimit": 19000,
  "creditsRemaining": 17750,
  "purchasedCredits": 2000,
  "totalRemaining": 19750,
  "requests": 1180
}