---
title: Analytics
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[DNS](https://developers.cloudflare.com/api/typescript/resources/dns)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Analytics

#### AnalyticsReports

##### [Table](https://developers.cloudflare.com/api/typescript/resources/dns/subresources/analytics/subresources/reports/methods/get)

Deprecated

client.dns.analytics.reports.get(ReportGetParams { zone\_id, dimensions, filters, 5 more } params, RequestOptionsoptions?): [Report](https://developers.cloudflare.com/api/typescript/resources/dns#%28resource%29%20dns.analytics.reports%20%3E%20%28model%29%20report%20%3E%20%28schema%29) { data, data\_lag, max, 4 more } 

GET/zones/{zone\_id}/dns\_analytics/report

##### ModelsExpand Collapse 

Report { data, data\_lag, max, 4 more } 

data: Array<Data\>

Array with one row per combination of dimension values.

dimensions: Array<string\>

Array of dimension values, representing the combination of dimension values corresponding to this row.

metrics: Array<number\>

Array with one item per requested metric. Each item is a single value.

data\_lag: number

Number of seconds between current time and last processed event, in another words how many seconds of data could be missing.

minimum0

max: unknown

Maximum results for each metric (object mapping metric names to values). Currently always an empty object.

min: unknown

Minimum results for each metric (object mapping metric names to values). Currently always an empty object.

query: Query { dimensions, limit, metrics, 4 more } 

dimensions: Array<string\>

Array of dimension names.

limit: number

Limit number of returned metrics.

metrics: Array<string\>

Array of metric names.

since: string

Start date and time of requesting data period in ISO 8601 format.

formatdate-time

until: string

End date and time of requesting data period in ISO 8601 format.

formatdate-time

filters?: string

Segmentation filter in ‘attribute operator value’ format.

sort?: Array<string\>

Array of dimensions to sort by, where each dimension may be prefixed by - (descending) or + (ascending).

rows: number

Total number of rows in the result.

minimum0

totals: unknown

Total results for metrics across all data (object mapping metric names to values).

#### AnalyticsReportsBytimes

##### [By Time](https://developers.cloudflare.com/api/typescript/resources/dns/subresources/analytics/subresources/reports/subresources/bytimes/methods/get)

Deprecated

client.dns.analytics.reports.bytimes.get(BytimeGetParams { zone\_id, dimensions, filters, 6 more } params, RequestOptionsoptions?): [ByTime](https://developers.cloudflare.com/api/typescript/resources/dns#%28resource%29%20dns.analytics.reports.bytimes%20%3E%20%28model%29%20by%5Ftime%20%3E%20%28schema%29) { data, data\_lag, max, 5 more } 

GET/zones/{zone\_id}/dns\_analytics/report/bytime

##### ModelsExpand Collapse 

ByTime { data, data\_lag, max, 5 more } 

data: Array<Data\>

Array with one row per combination of dimension values.

dimensions: Array<string\>

Array of dimension values, representing the combination of dimension values corresponding to this row.

metrics: Array<Array<number\>\>

Array with one item per requested metric. Each item is an array of values, broken down by time interval.

data\_lag: number

Number of seconds between current time and last processed event, in another words how many seconds of data could be missing.

minimum0

max: unknown

Maximum results for each metric (object mapping metric names to values). Currently always an empty object.

min: unknown

Minimum results for each metric (object mapping metric names to values). Currently always an empty object.

query: Query { dimensions, limit, metrics, 5 more } 

dimensions: Array<string\>

Array of dimension names.

limit: number

Limit number of returned metrics.

metrics: Array<string\>

Array of metric names.

since: string

Start date and time of requesting data period in ISO 8601 format.

formatdate-time

time\_delta: "all" | "auto" | "year" | 7 more

Unit of time to group data by.

One of the following:

"all"

"auto"

"year"

"quarter"

"month"

"week"

"day"

"hour"

"dekaminute"

"minute"

until: string

End date and time of requesting data period in ISO 8601 format.

formatdate-time

filters?: string

Segmentation filter in ‘attribute operator value’ format.

sort?: Array<string\>

Array of dimensions to sort by, where each dimension may be prefixed by - (descending) or + (ascending).

rows: number

Total number of rows in the result.

minimum0

time\_intervals: Array<Array<string\>\>

Array of time intervals in the response data. Each interval is represented as an array containing two values: the start time, and the end time.

totals: unknown

Total results for metrics across all data (object mapping metric names to values).