Skip to content
scrapeatlas.Dashboard

Account

Account usage API

Read your account’s recorded API usage and request activity.

2 endpointsx-api-key

Explore daily usage totals and individual request metadata for your authenticated account.

API availability: Available

Base URL · local workerhttp://localhost:3100Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/usage

Get account usage

Return daily UTC request and error totals by platform for the authenticated account. Choose a period with days. Accepts a customer API key or first-party dashboard session.

Reference
GET/v1/activity

Get account activity

Return recorded request metadata for the authenticated account, newest first. Filter by UTC window, platform, operation and HTTP status; continue with the returned cursor. Accepts customer API keys and first-party dashboard sessions.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/usage?days=7" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • period: 1–30 UTC days, including today
  • groups: 2048 rows maximum
  • timeout: 10 seconds including authentication and query
  • concurrency: 2 analytics queries per account, shared gateway global cap
  • rate: 30 queries/minute per account; in-memory single-instance admission
  • retention: 30 days; TTL deletion is asynchronous and queries enforce the visible window
Error codes
4
HTTPfailure.codeMeaning
400invalid_requestInvalid, duplicate or unknown parameter
401unauthorizedMissing or invalid session/customer key
429busyAccount analytics query limit
503busyAnalytics or authentication unavailable, or global admission full