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.

This tool is part of the Engagement Tools category.

Parameters

Name	Type	Required	Description
user_account_id	string	Yes	The ID of the user account to get engagement for

Example Request

{
  "user_account_id": "ua_123456"
}

Example Response

{
  "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 - View engagement trends over time
• Refresh Account Engagements - Refresh engagement data
• Get Content Engagement - Get engagement for specific content