This tool is part of the Demographics Tools category.

​
Parameters

NameTypeRequiredDescription
user_account_idstringYesThe ID of the user account to get age breakdown data for

​
Example Request

{
  "user_account_id": "ua_12345678"
}

​
Example Response

{
  "id": "age_12345678",
  "user_account_id": "ua_12345678",
  "platform": "INSTAGRAM",
  "data": {
    "13-17": 5.2,
    "18-24": 32.7,
    "25-34": 41.5,
    "35-44": 12.3,
    "45-54": 6.8,
    "55-64": 1.2,
    "65+": 0.3
  },
  "created_at": "2023-06-15T10:30:00.000Z",
  "updated_at": "2023-06-15T10:30:00.000Z",
  "last_refreshed_at": "2023-06-15T10:30:00.000Z"
}

​
Usage Notes

  • Age ranges and formats may vary by platform. The example above shows a common Instagram format.
  • Values in the data object represent percentages of the total audience that fall into each age range.
  • Not all platforms provide age demographic data. If unavailable, an appropriate error will be returned.
  • Age data may be subject to platform-specific privacy thresholds - small audience segments may be excluded.
  • For the most current data, consider using Refresh Demographics before retrieving age breakdown.
  • Different platforms may provide different levels of granularity in age ranges.
  • Data is typically based on self-reported ages or platform estimations.

​
Platform-Specific Notes

  • Instagram/Facebook: Provides data in age ranges as shown in the example.
  • YouTube: May provide slightly different age ranges (e.g., 18-24, 25-34, etc.).
  • TikTok: Provides detailed age demographics for business accounts.
  • LinkedIn: May provide professional demographics including age and seniority.
  • X (Twitter): Demographic data may be more limited compared to other platforms.