> ## 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 Engagement Trends

> Retrieves engagement trend data for a user account over a specified time period. This tool provides historical engagement metrics that show how account performance has changed over time, allowing you to analyze growth patterns and content effectiveness.

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

## Parameters

| Name              | Type   | Required | Description                                             |
| ----------------- | ------ | -------- | ------------------------------------------------------- |
| user\_account\_id | string | Yes      | The ID of the user account to get engagement trends for |
| period            | string | No       | Time period for engagement trends (week, month, year)   |

## Example Request

```json theme={null}
{
  "user_account_id": "ua_12345678",
  "period": "month"
}
```

## Example Response

```json theme={null}
{
  "user_account_id": "ua_12345678",
  "platform": "INSTAGRAM",
  "period": "month",
  "start_date": "2023-05-01",
  "end_date": "2023-05-31",
  "metrics": {
    "views": {
      "total": 245631,
      "trend": 15.3,
      "data": [
        {"date": "2023-05-01", "value": 6532},
        {"date": "2023-05-02", "value": 7215},
        // ... additional daily data points
        {"date": "2023-05-31", "value": 8943}
      ]
    },
    "likes": {
      "total": 18742,
      "trend": 8.7,
      "data": [
        {"date": "2023-05-01", "value": 521},
        {"date": "2023-05-02", "value": 487},
        // ... additional daily data points
        {"date": "2023-05-31", "value": 689}
      ]
    },
    "comments": {
      "total": 2384,
      "trend": 12.4,
      "data": [
        {"date": "2023-05-01", "value": 67},
        {"date": "2023-05-02", "value": 54},
        // ... additional daily data points
        {"date": "2023-05-31", "value": 91}
      ]
    },
    "followers": {
      "net_gain": 1253,
      "trend": 5.8,
      "data": [
        {"date": "2023-05-01", "value": 43},
        {"date": "2023-05-02", "value": 38},
        // ... additional daily data points
        {"date": "2023-05-31", "value": 52}
      ]
    }
  }
}
```

## Usage Notes

* The `period` parameter determines the time range for which trend data is returned:
  * `week`: Last 7 days
  * `month`: Last 30 days
  * `year`: Last 365 days
* If `period` is not specified, it defaults to `month`.
* The response includes aggregate totals, trend percentages, and time-series data for each metric.
* The `trend` values represent percentage change compared to the previous equivalent time period.
* Available metrics may vary by platform. Common metrics include views, likes, comments, shares, and follower growth.
* The `data` arrays contain daily data points for the specified period.
* For the most current trend data, consider using [Refresh Account Engagements](./refreshAccountEngagements) first.
* Historical data may be limited based on the platform and account tier.

## Platform-Specific Notes

* **Instagram**: Provides metrics such as reach, impressions, profile visits, and follower growth.
* **YouTube**: Offers watch time, views, subscriber growth, and engagement rates.
* **TikTok**: Includes video views, profile views, likes, comments, and follower growth.
* **Facebook**: Provides page views, reactions, comments, shares, and follower metrics.
* **LinkedIn**: Offers impression data, engagement rates, and follower statistics.

## Related Tools

* [Get Account Engagement](./getAccountEngagement) - Get current engagement metrics
* [Get Top Performing Content](./getTopPerformingContent) - See which content is performing best
* [Refresh Account Engagements](./refreshAccountEngagements) - Update engagement data from the platform