This tool is part of the Engagement Tools category.

​
Parameters

NameTypeRequiredDescription
user_account_idstringYesThe ID of the user account to get engagement trends for
periodstringNoTime 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.