Traffic breakdown
Retrieve traffic (in GB) grouped by a dimension (package, proxy_type, tier, country, domain, or ingress_ip), as a series of interval buckets. When group_by=package, keys are package names. The date range may span at most 365 days. If interval is omitted it is chosen automatically from the range (< 24 h → hour, < 60 days → day, otherwise month). Explicit intervals are validated: hour needs a range of at most 24 hours, day between 24 hours and 180 days, month at least 60 days.
If the API key is restricted to specific packages, results (and any package_ids filter) are limited to those packages.
Requires the proxy:analytics:read scope.
Authorizations
API key secret (starts with s_live_). Create keys in the dashboard under Settings → API keys, or via POST /v1/api-keys/. Send it as Authorization: Bearer <secret>.
Body
Request model for traffic breakdown analysis.
Start of the query range (ISO 8601).
End of the query range (ISO 8601). At most 365 days after from_date.
Allowed grouping dimensions for analytics queries.
package, proxy_type, tier, country, domain, ingress_ip Bucket size for the series. Auto-selected from the range when omitted (< 24 h → hour, < 60 days → day, otherwise month).
hour, day, month Restrict results to these package IDs.
Restrict results to network types: residential and/or mobile.
Restrict results to tiers (1, 2, or 3).
Restrict results to these ISO country codes.
Restrict results to traffic sent to these domains.
Response
Successful Response