Overview

Bucket aggregations group matching documents into buckets.

Use bucket aggregations when you want segmented analytics (for example by category, price tier, or time window).

Available Operators

Operator	What it groups by
$terms	Distinct field values
$range	Explicit from / to ranges
$histogram	Fixed numeric intervals
$dateHistogram	Fixed date/time intervals
$facet	Hierarchical FACET paths

Behavior Notes

• Bucket operators can contain nested $aggs.
• $terms, $range, $histogram, and $dateHistogram support nested $aggs.
• $facet does not support nested $aggs and cannot be used as a sub-aggregation.