Get Instagram account insights
Returns account-wide Instagram insights across feed, stories, explore, and profile activity. The date range defaults to the last 30 days and cannot exceed 90 days. Only reach supports daily time-series output. Missing Meta metrics are omitted rather than reported as zero. Each successful call costs 1 credit.
/v1/analytics/instagram/account-insightsAuthorization
accessKey In: header
Query Parameters
Integration ID for the connected Instagram account.
Comma-separated account metrics. Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares, replies, reposts, follows_and_unfollows, profile_links_taps.
"reach,views,accounts_engaged,total_interactions"Start date (YYYY-MM-DD). Defaults to 30 days ago.
dateEnd date (YYYY-MM-DD). Defaults to today.
datetotal_value returns an aggregate; time_series returns daily reach values.
"total_value"Optional Meta breakdown dimension. Only valid with metricType=total_value.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/analytics/instagram/account-insights?accountId=string"{
"success": true,
"accountId": "string",
"platform": "instagram",
"dateRange": {
"since": "2019-08-24",
"until": "2019-08-24"
},
"metricType": "total_value",
"metrics": {
"property1": {
"total": 0,
"values": [
{
"date": "2019-08-24",
"value": 0
}
],
"breakdowns": [
{
"dimensionKeys": [
"string"
],
"results": [
{
"dimensionValues": [
"string"
],
"value": 0
}
]
}
]
},
"property2": {
"total": 0,
"values": [
{
"date": "2019-08-24",
"value": 0
}
],
"breakdowns": [
{
"dimensionKeys": [
"string"
],
"results": [
{
"dimensionValues": [
"string"
],
"value": 0
}
]
}
]
}
},
"dataDelay": "string"
}{
"success": true,
"message": "string"
}{
"success": true,
"message": "string"
}{
"success": true,
"message": "string"
}{
"success": true,
"message": "string"
}