http_requests_overview_adaptive_groups

Analytics resource

This is a time-bounded analytics resource. Queries against it differ from typical CRUD resources in a few ways:

• since and until are required. Both are RFC3339 timestamps and define the analytics window (e.g. since = '2026-05-28T00:00:00Z', until = '2026-05-29T00:00:00Z'). Queries without them will fail.
• Row cap via limit. The limit parameter (default 100) bounds the response. Widen the time window or raise limit to return more rows.
• Token scope. Cloudflare's analytics endpoints require an API token with Account -> Analytics -> Read permission, which is broader than typical zone-scoped tokens. A token without it will return empty results.

Creates, updates, deletes, gets or lists a http_requests_overview_adaptive_groups resource.

Overview

Name	http_requests_overview_adaptive_groups
Type	Resource
Id	cloudflare.zones.http_requests_overview_adaptive_groups

Fields

The following fields are returned by SELECT queries:

list

Response

Name	Datatype	Description
client_country_name	string	ISO-3166 alpha-2 country code.
edge_response_content_type_name	string	Response content type.
bytes	integer	Total bytes served.
cached_bytes	integer	Bytes served from cache.
cached_requests	integer	Requests served from cache.
datetime	string (date-time)	Minute-bucketed timestamp.
edge_response_status	integer	HTTP status returned to the client.
page_views	integer	Successful HTML content requests.
requests	integer	Total request count for the tuple.
user_agent_browser	string	Browser parsed from user agent.
visits	integer	Cross-referer visit count.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	zone_tag, since, until	limit	HTTP request overview for a zone, adaptive-sampled, grouped by minute, client country, HTTP status, content type, and browser. Lighter-weight than zone_http_requests_adaptive_groups. Replaces the deprecated REST /zones/{zone_id}/analytics/colos endpoint.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
since	string (date-time)	Lower bound (inclusive). RFC3339.
until	string (date-time)	Upper bound (exclusive). RFC3339.
zone_tag	string	Cloudflare zone ID (the 32-char hex tag).
limit	integer	Maximum dimension-tuple rows per call.

SELECT examples

list

HTTP request overview for a zone, adaptive-sampled, grouped by minute, client country, HTTP status, content type, and browser. Lighter-weight than zone_http_requests_adaptive_groups. Replaces the deprecated REST /zones/{zone_id}/analytics/colos endpoint.

SELECT
client_country_name,
edge_response_content_type_name,
bytes,
cached_bytes,
cached_requests,
datetime,
edge_response_status,
page_views,
requests,
user_agent_browser,
visits
FROM cloudflare.zones.http_requests_overview_adaptive_groups
WHERE zone_tag = '{{ zone_tag }}' -- required
AND since = '{{ since }}' -- required
AND until = '{{ until }}' -- required
AND limit = '{{ limit }}'
;