---
title: Analytics Query
---

[Skip to content](#%5Ftop) 

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

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Analytics Query

##### [Query analytics summary](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/methods/summary)

analytics\_query.summary(strdataset, AnalyticsQuerySummaryParams\*\*kwargs)  \-> [AnalyticsQuerySummaryResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery%20%3E%20%28model%29%20analytics%5Fquery%5Fsummary%5Fresponse%20%3E%20%28schema%29)

POST/accounts/{account\_id}/analytics/query/{dataset}/summary

##### [Query analytics timeseries](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/methods/timeseries)

analytics\_query.timeseries(strdataset, AnalyticsQueryTimeseriesParams\*\*kwargs)  \-> [AnalyticsQueryTimeseriesResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery%20%3E%20%28model%29%20analytics%5Fquery%5Ftimeseries%5Fresponse%20%3E%20%28schema%29)

POST/accounts/{account\_id}/analytics/query/{dataset}/timeseries

##### [Query analytics top-N](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/methods/top%5Fn)

analytics\_query.top\_n(strdataset, AnalyticsQueryTopNParams\*\*kwargs)  \-> SyncSinglePage\[[AnalyticsQueryTopNResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery%20%3E%20%28model%29%20analytics%5Fquery%5Ftop%5Fn%5Fresponse%20%3E%20%28schema%29)\]

POST/accounts/{account\_id}/analytics/query/{dataset}/top-n

##### ModelsExpand Collapse 

class AnalyticsQuerySummaryResponse: …

current\_total: List\[Dict\[str, object\]\]

Aggregated stats for the requested time range.

previous\_total: List\[Dict\[str, object\]\]

Aggregated stats for the equivalent preceding time range, for trend comparison.

class AnalyticsQueryTimeseriesResponse: …

resolution: str

The resolution used for time bucketing.

slots: List\[Dict\[str, object\]\]

Time-bucketed result rows. Each slot contains a `time_bucket` field plus the requested stats and group-by dimensions.

Dict\[str, object\]

Maps field names to values. Keys represent stat names and group-by column names. Values depend on the dataset (strings, numbers, booleans).

#### Analytics QueryData Security

#### Analytics QueryData SecurityContent Findings

##### [Top integrations by content findings](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/subresources/data%5Fsecurity/subresources/content%5Ffindings/methods/top%5Fn)

analytics\_query.data\_security.content\_findings.top\_n(ContentFindingTopNParams\*\*kwargs)  \-> SyncSinglePage\[[ContentFindingTopNResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery.data%5Fsecurity.content%5Ffindings%20%3E%20%28model%29%20content%5Ffinding%5Ftop%5Fn%5Fresponse%20%3E%20%28schema%29)\]

POST/accounts/{account\_id}/analytics/query/data-security/content-findings/top-n

##### ModelsExpand Collapse 

Dict\[str, object\]

Maps field names to values. Keys represent stat names and group-by column names. Values depend on the dataset (strings, numbers, booleans).

#### Analytics QueryData SecurityFindings

##### [Data security findings summary](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/subresources/data%5Fsecurity/subresources/findings/methods/summary)

analytics\_query.data\_security.findings.summary(FindingSummaryParams\*\*kwargs)  \-> [FindingSummaryResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery.data%5Fsecurity.findings%20%3E%20%28model%29%20finding%5Fsummary%5Fresponse%20%3E%20%28schema%29)

POST/accounts/{account\_id}/analytics/query/data-security/findings/summary

##### [Data security findings timeseries](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery/subresources/data%5Fsecurity/subresources/findings/methods/timeseries)

analytics\_query.data\_security.findings.timeseries(FindingTimeseriesParams\*\*kwargs)  \-> [FindingTimeseriesResponse](https://developers.cloudflare.com/api/python/resources/analytics%5Fquery#%28resource%29%20analytics%5Fquery.data%5Fsecurity.findings%20%3E%20%28model%29%20finding%5Ftimeseries%5Fresponse%20%3E%20%28schema%29)

POST/accounts/{account\_id}/analytics/query/data-security/findings/timeseries

##### ModelsExpand Collapse 

class FindingSummaryResponse: …

current\_total: List\[Dict\[str, object\]\]

Aggregated stats for the requested time range.

previous\_total: List\[Dict\[str, object\]\]

Aggregated stats for the equivalent preceding time range, for trend comparison.

class FindingTimeseriesResponse: …

Merged CASB and CDE findings timeseries result.

slots: List\[Dict\[str, object\]\]

Contains time-bucketed result rows. Each slot includes a `timestamp` plus `content` and `posture` maps with `cloud` and `saas` keys.

resolution: Optional\[str\]

Always null for this endpoint.