> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Info>
  This tool is part of the [Demographics Tools](./index) category.
</Info>

## Parameters

| Name              | Type   | Required | Description                                              |
| ----------------- | ------ | -------- | -------------------------------------------------------- |
| user\_account\_id | string | Yes      | The ID of the user account to get age breakdown data for |

## Example Request

```json theme={null}
{
  "user_account_id": "ua_12345678"
}
```

## Example Response

```json theme={null}
{
  "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](./refreshDemographics) 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](./getDemographics) - Get general demographic data
* [Refresh Demographics](./refreshDemographics) - Refresh demographic data from platforms
* [Fetch Demographics](./fetchDemographics) - Fetch the latest demographics directly from the platform
* [Get Account Engagement](../engagement/getAccountEngagement) - Get engagement metrics for a user account