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

> Retrieves engagement metrics for one or more user accounts. This tool provides access to key performance indicators and engagement statistics aggregated at the account level.

<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 for |

## Example Request

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

## Example Response

```json theme={null}
{
  "id": "eng_789012",
  "account_id": "acc_345678",
  "day": "2023-06-15",
  "view": "45231",
  "comment": "512",
  "like": "3892",
  "share": "237",
  "subscriber_gain": "89",
  "subscriber_loss": "12",
  "reach": "67439",
  "engagement": "4641",
  "profile_activity": "821",
  "profile_visit": "1238",
  "save": "347",
  "total_watchtime_in_hour": 923.5,
  "average_watchtime_in_seconds": 74.2,
  "created_at": "2023-06-16T00:05:23.000Z",
  "updated_at": "2023-06-16T00:05:23.000Z"
}
```

## Metric Definitions

| Metric                          | Description                                                     |
| ------------------------------- | --------------------------------------------------------------- |
| view                            | Total number of content views for the account                   |
| comment                         | Total number of comments received on account content            |
| like                            | Total number of likes received on account content               |
| share                           | Total number of times account content has been shared           |
| subscriber\_gain                | Number of new followers/subscribers gained                      |
| subscriber\_loss                | Number of followers/subscribers lost                            |
| reach                           | Number of unique accounts that have seen the account's content  |
| engagement                      | Total engagement actions (likes + comments + shares + saves)    |
| profile\_activity               | Actions taken on the account profile page                       |
| profile\_visit                  | Number of visits to the account profile                         |
| save                            | Number of times account content has been saved/bookmarked       |
| total\_watchtime\_in\_hour      | Total hours of watch time for video content (where applicable)  |
| average\_watchtime\_in\_seconds | Average watch time per video view in seconds (where applicable) |

## Usage Notes

* Engagement metrics may vary by platform, and not all metrics will be available for all platforms.
* For YouTube and LinkedIn accounts, metrics are accumulated over time, showing lifetime totals.
* For other platforms like Instagram, metrics show the specific values for the date.
* Historical data may be available by checking multiple day records.
* Metrics like `subscriber_gain` and `subscriber_loss` are daily values, not cumulative totals.
* Bigint values are returned as strings to preserve precision.

## Related Tools

* [Get Engagement Trends](./getEngagementTrends) - View engagement trends over time
* [Refresh Account Engagements](./refreshAccountEngagements) - Refresh engagement data
* [Get Content Engagement](./getContentEngagement) - Get engagement for specific content