Get Audience Age Breakdown

Retrieves detailed age demographic breakdown for the audience of a specific user account. This tool provides insight into the age distribution of followers, subscribers, or viewers across different age ranges.Retrieves detailed age demographic breakdown for the audience of a specific user account. This tool provides insight into the age distribution of followers, subscribers, or viewers across different age ranges.

This tool is part of the Demographics Tools category.

Parameters

Name	Type	Required	Description
user_account_id	string	Yes	The 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.

Related Tools

• Get Demographics - Get general demographic data
• Refresh Demographics - Refresh demographic data from platforms
• Fetch Demographics - Fetch the latest demographics directly from the platform
• Get Account Engagement - Get engagement metrics for a user account