Menu
Docs/Usage API

Usage API

Check your current usage, remaining quota, and performance analytics.

GET/v1/usage

Response

{
  "plan": "growth",
  "period": {
    "start": "2026-03-10T00:00:00.000Z",
    "end": "2026-04-09T23:59:59.999Z"
  },
  "usage": {
    "requests": 12847,
    "limit": 25000,
    "remaining": 12153,
    "percentage": 51.4
  },
  "breakdown": {
    "screenshot": 9234,
    "og_image": 2891,
    "html_to_image": 722
  },
  "cache_hit_rate": 34.2,
  "avg_response_time_ms": 1180
}

Response fields

ParameterTypeDefaultDescription

Billing periods

SnapSharp uses anniversary-based billing — your usage resets on the same day each month that you created your account.

If you signed up on March 15, your billing period runs March 15 → April 14, then April 15 → May 14, and so on.

Dashboard analytics

The Usage dashboard provides additional visualization:

  • Daily usage chart — requests per day broken down by endpoint
  • Response time chart — p50, p95, p99 latency over time
  • Cache breakdown — hits vs misses ratio
  • Top URLs — most frequently screenshotted URLs
  • CSV export — download raw usage data as a CSV file

Set up webhooks to get notified when your usage hits 80% or 100% of your monthly limit.

Usage API