analytics:audience

Get audience demographics for an account: gender breakdown, top countries, and age groups.

Usage

simplified analytics:audience [options]

Options

FlagShortTypeRequiredDescription
--accounts-astringAccount ID
--fromstringStart date YYYY-MM-DD
--tostringEnd date YYYY-MM-DD (must be today or earlier)

Example

simplified analytics:audience \
  -a ACCOUNT_ID \
  --from 2026-03-01 \
  --to 2026-03-31

Response

{
  "gender": { "male": 42, "female": 55, "other": 3 },
  "countries": [
    { "code": "US", "percentage": 38 },
    { "code": "GB", "percentage": 12 }
  ],
  "age_groups": [
    { "range": "18-24", "percentage": 22 },
    { "range": "25-34", "percentage": 41 }
  ]
}