INSTAGRAM_GET_USER_INSIGHTS
Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). metric_type (time_series or total_value): When set to total_value, the API returns a total_value object instead of values. breakdown: Only applicable when metric_type=total_value and only for supported metrics. timeframe: Required for demographics-related metrics and overrides since/until for those metrics.
Remote instagram
Other tools also called INSTAGRAM_GET_USER_INSIGHTS?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"since": {
"type": "integer",
"title": "Since",
"default": null,
"nullable": true,
"description": "Start of time range (inclusive) as a Unix timestamp (seconds). Accepts date strings (YYYY-MM-DD) which will be converted to timestamps."
},
"until": {
"type": "integer",
"title": "Until",
"default": null,
"nullable": true,
"description": "End of time range (inclusive) as a Unix timestamp (seconds). Accepts date strings (YYYY-MM-DD) which will be converted to timestamps."
},
"metric": {
"type": "array",
"items": {
"enum": [
"reach",
"follower_count",
"profile_views",
"website_clicks",
"accounts_engaged",
"total_interactions",
"get_directions_clicks",
"text_message_clicks",
"engaged_audience_demographics",
"reached_audience_demographics",
"follower_demographics",
"online_followers"
],
"type": "string",
"title": "UserInsightMetric",
"properties": {},
"description": "Valid metrics for Instagram account-level insights."
},
"title": "Metric",
"nullable": true,
"description": "Metrics to retrieve for the user account. Allowed values: reach, follower_count, profile_views, website_clicks, accounts_engaged, total_interactions, get_directions_clicks, text_message_clicks, engaged_audience_demographics, reached_audience_demographics, follower_demographics, online_followers. Demographics metrics require timeframe parameter. If multiple metrics are provided, all must support the same period."
},
"period": {
"type": "string",
"title": "Period",
"default": "day",
"nullable": true,
"description": "Aggregation period for insights. Allowed values: day, week, days_28, lifetime. Allowed values depend on metric."
},
"breakdown": {
"type": "string",
"title": "Breakdown",
"default": null,
"nullable": true,
"description": "Breakdown to use when metric_type=total_value. Allowed values: contact_button_type, follow_type, media_product_type."
},
"timeframe": {
"type": "string",
"title": "Timeframe",
"default": null,
"nullable": true,
"description": "Timeframe for demographics-related metrics; overrides since/until for those metrics. Common values: last_14_days, last_30_days, last_90_days, prev_month, this_month, this_week."
},
"ig_user_id": {
"type": "string",
"title": "Ig User Id",
"default": null,
"nullable": true,
"description": "Instagram Business Account ID (optional, defaults to current user)"
},
"metric_type": {
"type": "string",
"title": "Metric Type",
"default": null,
"nullable": true,
"description": "Aggregation type for results. Allowed values: time_series, total_value."
},
"graph_api_version": {
"type": "string",
"title": "Graph Api Version",
"default": "v21.0",
"nullable": true
}
}
}