Get per-endpoint bandwidth breakdown

Returns bandwidth usage broken down by endpoint (screenshots, recordings, scrape, scrape_md, fetch, fetch_md, crawl, crawl_links, sitemap, monitors) for a date range. Each row carries raw bytes, the billing multiplier, and billable bytes. Endpoints with zero raw bytes for the range are omitted from `rows`; `totals` is always present. Default range is the last 30 days; max 366 days.

GET
/v1/usage/by-endpoint

Authorization

AuthorizationRequiredBearer <token>

API key. Manage keys from the dashboard at app.bytekit.com.

In: header

Query Parameters

fromstring

Start date (YYYY-MM-DD). Default 30 days ago.

Format: "date"
tostring

End date (YYYY-MM-DD). Default today.

Format: "date"
api_keystring

Filter by API key (prefixed ID, e.g. ak_xxx). When provided, scopes the breakdown to that key only. The key must belong to the requesting account; cross-account keys return an empty breakdown. When absent, aggregates across all keys.

curl https://api.bytekit.com \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Successful response.

{
  "from": "2019-08-24",
  "to": "2019-08-24",
  "rows": [
    {
      "endpoint": "screenshots",
      "raw_bytes": 0,
      "multiplier": 0,
      "billable_bytes": 0
    }
  ],
  "totals": {
    "raw_bytes": 0,
    "billable_bytes": 0
  }
}