Product / Content Aggregation API

​

Run one aggregation over a field of your products data, and return a single value.

Supported functions: max, min, sum, avg. A date field supports min and max only. A text, keyword or geo_point field is not supported, and returns 400.

{ "function": "max", "field": "published_at" }

{ "message": "success", "data": { "value": "2026-06-12T09:00:00Z" } }
Body·
required
application/json
  • field
    Type: string
    required

    The field to aggregate. A custom attribute uses its dotted path.

  • function
    Type: string enum
    required

    The aggregation to run.

    values
    • max
    • min
    • sum
    • avg
Responses
  • application/json
  • 400

    The field type does not support this function.

  • 401

    The API key is missing or wrong.

  • 404

    The field is not in the schema.

  • 422

    The request did not pass validation.

Request Example for post/v1/products/_aggregations
curl 'https://api.askmiso.com/v1/products/_aggregations?api_key=YOUR_SECRET_TOKEN' \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "function": "max",
  "field": "custom_attributes.read_minutes"
}'

{
  "message": "success",
  "data": {
    "value": 12
  }
}

Successful Response