Billing

Get historical customer product usage analytics

Admin-only retained REST/MCP product counts with exact distinct users, platform/user/endpoint rankings, calendar trends, range-wide excluded populations, separate charged billing credits, partial-period markers and evidence-based recommendations. Internal/test traffic and MCP initialization are excluded from product calls. HTTP 2xx is not a guarantee of MCP application success. Current account plans are not historical plan attribution. All-time covers retained records only. No public MCP tool or SDK entry is exposed.

get/admin/billing/analytics/usage

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/admin/billing/analytics/usage
  • Auth: API key in header x-api-key

Query parameters

range'7d' | '30d' | '90d' | 'all' | 'custom'

Window, default 90d; custom requires from and to

fromstring

Inclusive RFC3339 bound for range=custom

tostring

Exclusive RFC3339 bound, default now; cannot be future

bucket'day' | 'week' | 'month'

Calendar bucket, default month; weeks start Monday

timezone'UTC' | 'Asia/Shanghai'

Calendar timezone, default Asia/Shanghai

platformstring

Observed platform family from platforms[].key

endpointstring

Observed endpoint from endpoints[].key, without /api/v1/ prefix

user_idstring

Observed customer id from users[].user_id

Headers

x-api-keystring required

Admin API key required unless an Admin JWT is present

Response

OK

codeinteger
msgstring

Changes

No recorded changes to this operation across all 2 revisions of this API.