Usage Analytics

Retrieve content access usage analytics

GET /v1/analytics/usage

cURL

curl "https://api.raily.ai/v1/analytics/usage?period=30d&groupBy=day" \
  -H "Authorization: Bearer raily_sk_xxxxx"

Response

{
  "summary": {
    "totalRequests": 125430,
    "allowed": 118200,
    "denied": 7230,
    "uniqueRequesters": 45,
    "uniqueContent": 1250
  },
  "timeSeries": [
    { "date": "2024-01-01", "requests": 4180, "allowed": 3950, "denied": 230 },
    { "date": "2024-01-02", "requests": 4320, "allowed": 4100, "denied": 220 }
  ],
  "topContent": [
    { "id": "cnt_abc", "title": "AI Report 2024", "requests": 8500 },
    { "id": "cnt_def", "title": "Market Analysis", "requests": 6200 }
  ],
  "topRequesters": [
    { "id": "partner_openai", "name": "OpenAI", "requests": 45000 },
    { "id": "partner_anthropic", "name": "Anthropic", "requests": 32000 }
  ],
  "byDenialReason": [
    { "reason": "no_license", "count": 4500 },
    { "reason": "rate_limit_exceeded", "count": 2100 }
  ]
}

Query Parameters

period · string · default: "30d"

Time period: 7d, 30d, 90d, year, or all

startDate · string

Custom start date (ISO 8601)

endDate · string

Custom end date (ISO 8601)

groupBy · string · default: "day"

Grouping: hour, day, week, month

contentId · string

Filter by content ID

requesterId · string

Filter by requester ID

type · string

Filter by content type

Response

summary · object

Aggregated metrics

Show child attributes

totalRequests · integer

Total access requests

allowed · integer

Allowed requests

denied · integer

Denied requests

uniqueRequesters · integer

Unique requesters

uniqueContent · integer

Unique content accessed

timeSeries · array

Time-bucketed data points

topContent · array

Most accessed content

topRequesters · array

Most active requesters

cURL

curl "https://api.raily.ai/v1/analytics/usage?period=30d&groupBy=day" \
  -H "Authorization: Bearer raily_sk_xxxxx"

Response

{
  "summary": {
    "totalRequests": 125430,
    "allowed": 118200,
    "denied": 7230,
    "uniqueRequesters": 45,
    "uniqueContent": 1250
  },
  "timeSeries": [
    { "date": "2024-01-01", "requests": 4180, "allowed": 3950, "denied": 230 },
    { "date": "2024-01-02", "requests": 4320, "allowed": 4100, "denied": 220 }
  ],
  "topContent": [
    { "id": "cnt_abc", "title": "AI Report 2024", "requests": 8500 },
    { "id": "cnt_def", "title": "Market Analysis", "requests": 6200 }
  ],
  "topRequesters": [
    { "id": "partner_openai", "name": "OpenAI", "requests": 45000 },
    { "id": "partner_anthropic", "name": "Anthropic", "requests": 32000 }
  ],
  "byDenialReason": [
    { "reason": "no_license", "count": 4500 },
    { "reason": "rate_limit_exceeded", "count": 2100 }
  ]
}