Analyze usage trends over multiple months with forecasting and pattern detection.
GEThttps://api.aitronos.com/v1/analytics/usage/trends/{org_id}
org_id string required
The organization ID.
months integer
Number of months to analyze. Default: 6. Range: 1-24.
metric string optional
Metric type to analyze: neurons, synapses, or omit for combined metrics. Default: combined (null).
Returns trend analysis with growth rates and forecasts.
Bash
- Bash
- Python
- Python
- JavaScript
curl "https://api.aitronos.com/v1/analytics/usage/trends/org_abc123?months=6" \
-H "X-API-Key: $FREDDY_API_KEY"Response:
200 OK
{
"organization_id": "org_abc123",
"metric": null,
"period": {
"months": 6,
"start": "2025-06-01",
"end": "2025-11-30"
},
"trends": {
"overall_growth_rate": 0.18,
"monthly_data": [
{"month": "2025-06", "value": 8500},
{"month": "2025-07", "value": 9200},
{"month": "2025-08", "value": 10100},
{"month": "2025-09", "value": 11400},
{"month": "2025-10", "value": 13200},
{"month": "2025-11", "value": 15000}
],
"forecast_next_month": 17200
},
"patterns": [
{"type": "growth", "description": "Consistent month-over-month growth of ~18%"},
{"type": "seasonality", "description": "Higher usage on weekdays vs weekends"}
],
"forecasts": {
"next_month": 17200,
"next_quarter": 55000,
"confidence": "high"
}
}