This tool is part of the Demographics Tools category.

​
Parameters

NameTypeRequiredDescription
user_account_idstringYesThe ID of the user account to get demographics for

​
Example Request

{
  "user_account_id": "user_account_12345"
}

​
Example Response

{
  "user_account_id": "user_account_12345",
  "gender": {
    "male_percentage": 45,
    "female_percentage": 55
  },
  "age_groups": {
    "18-24": 20,
    "25-34": 35,
    "35-44": 25,
    "45-54": 15,
    "55+": 5
  },
  "locations": [
    { "country": "United States", "percentage": 65 },
    { "country": "United Kingdom", "percentage": 15 },
    { "country": "Canada", "percentage": 10 },
    { "country": "Australia", "percentage": 5 },
    { "country": "Other", "percentage": 5 }
  ]
}

​
Usage Notes

  • This method returns a demographic breakdown for a user account, including gender, age groups, and top locations.
  • If the user account does not exist or does not belong to the tenant app, an error will be returned.
  • For age-specific breakdowns, use Get Audience Age Breakdown.