Traffic Analytics
Get app dimension breakdown
Top values of one dimension for one app, summed across every bucket in range. A synthetic __other__ entry absorbs the long tail past the server's top-N cap (TRAFFIC_TOPN). An unrecognized dimension returns an empty array, not an error.
get/api/app/{uuid}/traffic/breakdown/{dimension}
Path parameters
uuidstring required
Coolify app UUID (or host, for Caddy — see README.md)
dimensionstring required
One of: status, method, country, referer, browser, os, device, protocol, scheme, tls, cache, bot.
Query parameters
fromstring date-time
Start date in ISO 8601 format (UTC timezone). If not provided, defaults to 1970-01-01T00:00:00Z.
tostring date-time
End date in ISO 8601 format (UTC timezone). If not provided, defaults to current time.
limitinteger
Number of ranked entries to return, applied after summing across buckets. Defaults to 50, capped at 1000.
Response
Top values of the dimension for the app
Example response
[
{
"value": "US",
"requests": 42000,
"bytes_out": 320000000
}
]