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.

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 trends for
period	string	No	Time period for engagement trends (week, month, year)

Example Request

{
  "user_account_id": "ua_12345678",
  "period": "month"
}

Example Response

{
  "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 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 - Get current engagement metrics
• Get Top Performing Content - See which content is performing best
• Refresh Account Engagements - Update engagement data from the platform