--- title: Analytics Query --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) 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/typescript/resources/analytics_query/methods/summary) client.analyticsQuery.summary(stringdataset, AnalyticsQuerySummaryParams {account\_id, filters, from, 3 more } params, RequestOptionsoptions?): [AnalyticsQuerySummaryResponse]() {currentTotal, previousTotal } POST/accounts/{account\_id}/analytics/query/{dataset}/summary ##### [Query analytics timeseries](https://developers.cloudflare.com/api/typescript/resources/analytics_query/methods/timeseries) client.analyticsQuery.timeseries(stringdataset, AnalyticsQueryTimeseriesParams {account\_id, filters, from, 4 more } params, RequestOptionsoptions?): [AnalyticsQueryTimeseriesResponse]() {resolution, slots } POST/accounts/{account\_id}/analytics/query/{dataset}/timeseries ##### [Query analytics top-N](https://developers.cloudflare.com/api/typescript/resources/analytics_query/methods/top_n) client.analyticsQuery.topN(stringdataset, AnalyticsQueryTopNParams {account\_id, filters, from, 5 more } params, RequestOptionsoptions?): SinglePage< [AnalyticsQueryTopNResponse]()> POST/accounts/{account\_id}/analytics/query/{dataset}/top-n ##### ModelsExpand Collapse
AnalyticsQuerySummaryResponse {currentTotal, previousTotal } currentTotal: Array<Record<string, unknown>> Aggregated stats for the requested time range. Link to this property previousTotal: Array<Record<string, unknown>> Aggregated stats for the equivalent preceding time range, for trend comparison. Link to this property
[Link to this property](<#(resource)%20analytics_query%20%3E%20(model)%20analytics_query_summary_response%20%3E%20(schema)>)
AnalyticsQueryTimeseriesResponse {resolution, slots } resolution: string The resolution used for time bucketing. Link to this property slots: Array<Record<string, unknown>> Time-bucketed result rows. Each slot contains a time_bucket field plus the requested stats and group-by dimensions. Link to this property
[Link to this property](<#(resource)%20analytics_query%20%3E%20(model)%20analytics_query_timeseries_response%20%3E%20(schema)>) AnalyticsQueryTopNResponse = Record Maps field names to values. Keys represent stat names and group-by column names. Values depend on the dataset (strings, numbers, booleans). [Link to this property](<#(resource)%20analytics_query%20%3E%20(model)%20analytics_query_top_n_response%20%3E%20(schema)>) #### Analytics QueryData Security #### Analytics QueryData SecurityContent Findings ##### [Top integrations by content findings](https://developers.cloudflare.com/api/typescript/resources/analytics_query/subresources/data_security/subresources/content_findings/methods/top_n) client.analyticsQuery.dataSecurity.contentFindings.topN(ContentFindingTopNParams {account\_id, filters, from, 2 more } params, RequestOptionsoptions?): SinglePage< [ContentFindingTopNResponse]()> POST/accounts/{account\_id}/analytics/query/data-security/content-findings/top-n ##### ModelsExpand Collapse ContentFindingTopNResponse = Record Maps field names to values. Keys represent stat names and group-by column names. Values depend on the dataset (strings, numbers, booleans). [Link to this property](<#(resource)%20analytics_query.data_security.content_findings%20%3E%20(model)%20content_finding_top_n_response%20%3E%20(schema)>) #### Analytics QueryData SecurityFindings ##### [Data security findings summary](https://developers.cloudflare.com/api/typescript/resources/analytics_query/subresources/data_security/subresources/findings/methods/summary) client.analyticsQuery.dataSecurity.findings.summary(FindingSummaryParams {account\_id, filters, from, to } params, RequestOptionsoptions?): [FindingSummaryResponse]() {currentTotal, previousTotal } POST/accounts/{account\_id}/analytics/query/data-security/findings/summary ##### [Data security findings timeseries](https://developers.cloudflare.com/api/typescript/resources/analytics_query/subresources/data_security/subresources/findings/methods/timeseries) client.analyticsQuery.dataSecurity.findings.timeseries(FindingTimeseriesParams {account\_id, filters, from, to } params, RequestOptionsoptions?): [FindingTimeseriesResponse]() {slots, resolution } POST/accounts/{account\_id}/analytics/query/data-security/findings/timeseries ##### ModelsExpand Collapse
FindingSummaryResponse {currentTotal, previousTotal } currentTotal: Array<Record<string, unknown>> Aggregated stats for the requested time range. Link to this property previousTotal: Array<Record<string, unknown>> Aggregated stats for the equivalent preceding time range, for trend comparison. Link to this property
[Link to this property](<#(resource)%20analytics_query.data_security.findings%20%3E%20(model)%20finding_summary_response%20%3E%20(schema)>)
FindingTimeseriesResponse {slots, resolution } Merged CASB and CDE findings timeseries result. slots: Array<Record<string, unknown>> Contains time-bucketed result rows. Each slot includes a timestamp plus content and posture maps with cloud and saas keys. Link to this property resolution?: string| null Always null for this endpoint. Link to this property
[Link to this property](<#(resource)%20analytics_query.data_security.findings%20%3E%20(model)%20finding_timeseries_response%20%3E%20(schema)>)