Aggregated statistics

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Service name.

Possible value:

• CDN

Beginning of the requested time period (ISO 8601/RFC 3339 format, UTC.)

Example:

• &from=2018-12-01T00:00:00.000

End of the requested time period (ISO 8601/RFC 3339 format, UTC.)

Example:

• &to=2018-12-01T01:00:00.000

Duration of time chunks into which the data will be divided.

Possible values:

• 1m - available only for up to 1 month in the past.
• 5m
• 15m
• 1h
• 1d

Types of statistics data.

Possible values:

• upstream_bytes - Traffic in bytes from an origin server to CDN servers or to origin shielding when used.
• sent_bytes - Traffic in bytes from CDN servers to clients.
• shield_bytes - Traffic in bytes from origin shielding to CDN servers.
• total_bytes - shield_bytes, upstream_bytes and sent_bytes combined.
• cdn_bytes - sent_bytes and shield_bytes combined.
• requests - Number of requests to edge servers.
• responses_2xx - Number of 2xx response codes.
• responses_3xx - Number of 3xx response codes.
• responses_4xx - Number of 4xx response codes.
• responses_5xx - Number of 5xx response codes.
• responses_hit - Number of responses with the header Cache: HIT.
• responses_miss - Number of responses with the header Cache: MISS.
• cache_hit_traffic_ratio - Formula: 1 - upstream_bytes / sent_bytes. We deduct the non-cached traffic from the total traffic amount.
• shield_usage - Origin shielding usage. To get accurate results, you must use grouping or filtering by a client or by a CDN resource.
• raw_logs_usage - Logs uploader usage. To get accurate results, you should use grouping or filtering by a client or by a CDN resource.

Output data grouping.

Possible values:

• client - Data is grouped by clients.
• resource - Data is grouped by CDN resources.
• region - Data is grouped by regions of CDN edge servers.
• country - Data is grouped by countries of CDN edge servers.
• vhost - Data is grouped by resources CNAMEs.
• client_country - Data is grouped by countries, based on end-users' location.

To request multiple values, use:

• &group_by=client&group_by=resource

Names of countries for which data should be displayed.

English short names from ISO 3166 standard without the definite article ("the") should be used.

To request multiple values, use:

• &countries=france&countries=denmark

Regions for which data is displayed.

Possible values:

• na - North America
• eu - Europe
• cis - Commonwealth of Independent States
• asia - Asia
• au - Australia
• latam - Latin America
• me - Middle East
• africa - Africa
• sa - South America

CDN resources IDs.

To request multiple values, use:

• &resource=1&resource=2

Client accounts IDs.

To request multiple values, use:

• &client=1&client=2