Analytics

Retrieve historical analytics data for your CDN resources, including traffic, request, and performance metrics within a specified time range.


Overview

Analytics Overview Historical Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired
resourcesany ofOptional
string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
typestring · enumRequiredPossible values:
fromstring · date-timeRequiredExample: 2024-11-12 00:00:00
tostring · date-timeRequiredExample: 2024-11-12 23:59:59
calc_typestring · enumOptionalDefault: request_numberPossible values:
timezoneany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/historical

No content

Analytics Overview Top Resources

post

Retrieve the top CDN resources within a specified time range, ranked by key traffic and usage signals.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
limitany ofOptional

Maximum number of resources to return.

integerOptional
or
nullOptional
pageany ofOptional

Page number for paginated results. Default is 1.

Default: 1
integerOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/top_resources

No content

Analytics Overview Errors

post

Retrieve a summary of error activity for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
limitany ofOptional

Maximum number of items to return.

integerOptional
or
nullOptional
pageany ofOptional

Page number for paginated results. Default is 1.

Default: 1
integerOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/errors

No content

Analytics Overview Visitors Countries

post

Retrieve a country breakdown of visitors for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
limitany ofOptional

Maximum number of items to return.

integerOptional
or
nullOptional
pageany ofOptional

Page number for paginated results. Default is 1.

Default: 1
integerOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/visitors_countries

No content

Analytics Overview Active Type

post

Retrieve active analytics metrics grouped by the specified type for your CDN resources within a selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
limitany ofOptional

Maximum number of items to return.

integerOptional
or
nullOptional
pageany ofOptional

Page number for paginated results. Default is 1.

Default: 1
integerOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/active_{type}

No content


Graphs

Analytics Cache Histogram Traffic

post

Retrieve a traffic histogram for the selected cache type within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
cache_typestringRequired

Cache type to query.

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Histogram interval (for example, 5m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/{cache_type}_traffic_report/graph

No content

Analytics Histogram

post

Retrieve a histogram time series for the selected analytics metric within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
typestring · enumRequired

Histogram metric type to query.

Possible values:
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Histogram interval (for example, 5m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/{type}_report/graph

No content

Analytics Histogram Status Code

post

Retrieve a histogram time series for the specified HTTP status code within a selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
status_codestringRequired

HTTP status code to query (for example, 200, 404, 500).

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Histogram interval (for example, 5m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/status_report/graph/{status_code}

No content

Analytics Histogram Domain

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
param_typestringRequired

The specific parameter type for the domain report (e.g., traffic, bandwidth).

Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Histogram interval (for example, 5m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v2/domain_report_{param_type}/graph

No content


Detail Reports

Analytics Overview Analytics Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/analytics_report

No content

Analytics Overview Error Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/error_report

No content

Analytics Overview Gpu Report

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/gpu_report

No content

Traffic Report Detail

post

Retrieve detailed traffic analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/traffic_report/detail

No content

Requests Report Detail

post

Retrieve detailed request analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/requests_report/detail

No content


Errors

Error Logs Status Codes

post

List error log entries grouped by HTTP status codes for the selected time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
pageintegerOptional

Page number for paginated results. Default is 1.

Default: 1
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
page_sizeany ofOptional

Number of items to return per page.

integerOptional
or
nullOptional
statusCodesinteger[]Optional

List of HTTP status codes to filter on.

Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/error_logs/status_codes

No content

Error Report Status Codes

post

Retrieve an HTTP status code breakdown for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/error_report/status_codes

No content


Regions

Analytics Overview Region

post

Retrieve regional analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/region

No content

Analytics Overview Region Billing

post

Retrieve region-based billing analytics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/region_billing

No content


GPU

GPU Stat Details

post

Retrieve GPU processing statistics for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
agg_typestring · enumOptional

Aggregation type for grouping results.

Default: formatPossible values:
io_process_filterany ofOptional

I/O process filter. Use all to include all values.

Default: all
stringOptional
or
string[]Optional
or
nullOptional
format_filterany ofOptional

Format filter. Use all to include all values.

Default: all
stringOptional
or
string[]Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/gpu_stat_details

No content

GPU Histogram Details

post

Retrieve a GPU histogram time series for your CDN resources within a specified time range.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Histogram interval (for example, 5m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/overview_report/gpu_histogram_details

No content

Storage Stat Details

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
organization_uuidstringRequired

Unique identifier of the organization in the Medianova Cloud Panel.

resourcesany ofOptional

List of resource UUIDs to include. Use null to include all resources.

string[]Optional
or
nullOptional
fromstring · date-timeRequired

Start timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the analytics query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/api/v1/storage_report/detail

No content


Traffic & Bandwidth

Analytics Histogram Traffic

post

Retrieve a traffic histogram time series for your CDN resources within a specified time range.

Body
organization_uuidstringRequired

The unique identifier of the organization.

resourcesany ofOptional

List of resource UUIDs to include. If omitted or null, the response includes all resources in the organization.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret and group the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Aggregation interval for the histogram (for example, 5m, 10m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

post
/api/v1/traffic_report/graph

Analytics Histogram Bandwidth

post

Retrieve a bandwidth histogram time series for your CDN resources within a specified time range.

Body
organization_uuidstringRequired

The unique identifier of the organization.

resourcesany ofOptional

List of resource UUIDs to include. If omitted or null, the response includes all resources in the organization.

string[]Optional
or
nullOptional
tierstring · enumOptional

Select the analytics tier to query. Use edge for edge-only analytics. Default is all.

Default: allPossible values:
fromstring · date-timeRequired

Start timestamp (inclusive) of the query range.

Example: 2024-11-12 00:00:00
tostring · date-timeRequired

End timestamp (inclusive) of the query range.

Example: 2024-11-12 23:59:59
timezoneany ofOptional

Time zone used to interpret and group the query time range (for example, Europe/Istanbul).

stringOptional
or
nullOptional
intervalany ofOptional

Aggregation interval for the histogram (for example, 5m, 10m, 1h).

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

post
/api/v1/bandwidth_report/graph

Last updated

Was this helpful?