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

{
  "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
​
timeSeries
array
Time-bucketed data points
​
topContent
array
Most accessed content
​
topRequesters
array
Most active requesters
curl "https://api.raily.ai/v1/analytics/usage?period=30d&groupBy=day" \
  -H "Authorization: Bearer raily_sk_xxxxx"

{
  "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 }
  ]
}