Use this endpoint to retrieve traffic analytics for your application. The response provides a comprehensive breakdown of visitor activity across multiple dimensions — including geographic location, device type, operating system, browser, HTTP method, URL path, referrer, and network provider — over either a daily or weekly time window. This data helps you understand how users interact with your application and identify traffic patterns.
Endpoint GET https://api.virtuscloud.app/v2/apps/{app_id}/network/analytics
Authorization Include your API key in the request header:
Path Parameters The unique identifier of your application. You can find this in the URL of your application’s dashboard.
Query Parameters The time window for the analytics data. Accepted values are "daily" (last 24 hours) and "weekly" (last 7 days). Defaults to "daily" if not specified.
Response Indicates the outcome of the request. Returns "success" when the operation completes without errors.
An object containing analytics data grouped by dimension. Each dimension is an array of data-point objects. Show Common data-point fields (shared across all dimensions)
The label for this data point within its dimension. For example, a country code ("BR"), device type ("desktop"), or path ("/about").
The number of unique visits attributed to this data point in the time period.
The total number of HTTP requests attributed to this data point.
The total bytes transferred for requests attributed to this data point.
An ISO 8601 timestamp representing the start of the time bucket for this data point.
Show Top-level response keys
Aggregated visit and request totals over time, without dimension segmentation.
Traffic breakdown by visitor country, using ISO 3166-1 alpha-2 country codes in the type field.
Traffic breakdown by device type (e.g. "desktop", "mobile", "tablet").
Traffic breakdown by operating system (e.g. "Windows", "macOS", "Linux").
Traffic breakdown by browser (e.g. "Chrome", "Firefox", "Safari").
Traffic breakdown by protocol (e.g. "https", "http").
Traffic breakdown by HTTP method (e.g. "GET", "POST").
Traffic breakdown by URL path (e.g. "/", "/api/health").
Traffic breakdown by referrer URL.
Traffic breakdown by network provider or CDN edge (e.g. "Cloudflare").
Examples curl --request GET \ --url "https://api.virtuscloud.app/v2/apps/{app_id}/network/analytics?range=daily" \ --header "Authorization: <api_key>"
Response Example { "status" : "success" , "response" : { "visits" : [ { "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "countries" : [ { "type" : "BR" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "devices" : [ { "type" : "desktop" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "os" : [ { "type" : "Windows" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "browsers" : [ { "type" : "Chrome" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "protocols" : [ { "type" : "https" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "methods" : [ { "type" : "GET" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "paths" : [ { "type" : "/" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "referers" : [ { "type" : "https://google.com" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ], "providers" : [ { "type" : "Cloudflare" , "visits" : 1 , "requests" : 4 , "bytes" : 9677 , "date" : "2025-05-31T18:45:00Z" } ] } }
This endpoint enforces a rate limit of one uncached request every 10 seconds. Repeated calls within that window will return a cached response.
