Network

Get edge analytics for the application's domains

Returns aggregated edge analytics (requests, bandwidth, status codes, etc.) for the application's primary domain and any configured custom domain.

Requires both start and end ISO timestamps. Maximum retention window is 7 days; the start is clamped to the application's creation date.

Optional drill-down filters (country, ip, path, status, os, browser, protocol, referer, provider, content_type, bot) narrow every breakdown to the matching traffic — feed back the exact type value returned by the corresponding breakdown in a previous response. Filters combine (AND).

Results are cached per bucket; on cache miss rate-limited to 10 calls per 60s per owner.

get/v2/apps/{appId}/network/analytics

Path parameters

appIdstring required

Application identifier. Optionally suffixed with -<workspaceId> to act on a workspace-shared application.

Query parameters

startstring date-time required

ISO 8601 start timestamp.

endstring date-time required

ISO 8601 end timestamp.

countrystring

Example:BR

Filter every breakdown to one client country (2-character code, e.g. BR).

ipstring

Example:203.0.113.45

Filter every breakdown to one client IP (exact IPv4/IPv6 match).

pathstring

Example:/api

Filter every breakdown to request paths starting with this prefix (e.g. /api covers /api/*).

statusstring

Example:404

Filter to one edge response status code, as returned in the status_codes breakdown.

osstring

Example:Windows

Filter to one client OS, as returned in the os breakdown.

browserstring

Example:Chrome

Filter to one client browser, as returned in the browsers breakdown.

protocolstring

Example:HTTP/2

Filter to one HTTP protocol, as returned in the protocols breakdown.

refererstring

Example:google.com

Filter to one referer host, as returned in the referers breakdown (Direct = no referer).

providerstring

Example:GOOGLE (15169)

Filter to one client network, as returned in the providers breakdown — e.g. GOOGLE (15169), a bare ASN number, or SQUARE-CLOUD-PLATFORM.

content_typestring

Example:json

Filter to one response content type, as returned in the content_types breakdown (Unknown = unclassified).

botstring

Example:Search Engine Crawler

Filter to one verified-bot category, as returned in the bots breakdown (Unverified = regular non-bot traffic).

Response

Aggregated edge analytics broken down by time, country, device, OS, browser, protocol, HTTP method, request path, referer, and client ASN — each as an array of buckets (type identifies the dimension; visits is unique visitors, requests is the request count, bytes is the response bytes served, date is the 15-minute window start). Plus four window-total breakdowns without date (top-N over the whole window): ips (top client IPs), status_codes, bots (verified bot categories; Unverified is regular traffic) and content_types. Returns an empty object ({}) when the requested window starts before the application's creation date.

status'success' required

Changes

No recorded changes to this endpoint across all 1 revision of this API.