Insights
Account, automation and post numbers.
Pull the numbers shown on the Instagram Studio dashboard into your own reports: the account’s reach and profile numbers from Instagram, what your automations did, and the best posts. period is week (7 days) or days_28 (the default).
Copy this section as context for your AI coding agent
curl -X GET 'https://api.chatverse.io/v1/instagram/insights?period=days_28' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
{
"profile": {
"id": "17841401234567890",
"username": "yourbrand",
"name": "Your Brand",
"followers_count": 12840,
"follows_count": 310,
"media_count": 214
},
"reach": 48210,
"profile_views": 2450,
"accounts_engaged": 3120,
"total_interactions": 6890,
"website_clicks": 184,
"likes": 5210,
"comments": 640,
"saves": 410,
"previous": {
"reach": 41030,
"profile_views": 2110,
"accounts_engaged": 2870,
"total_interactions": 6020
}
}Unlike the other endpoints this returns Instagram’s numbers as they are, without the success/data wrapper. previous holds the period before, for comparison. A metric Instagram doesn’t give for the account is left out. Cached for a few minutes.
curl -X GET 'https://api.chatverse.io/v1/instagram/automation-impact?period=days_28' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
{
"success": true,
"message": "Automation impact",
"data": {
"period": "days_28",
"tracking": true,
"tracking_since": "2026-10-01T00:00:00+00:00",
"period_totals": {
"comment_replies": 640,
"comment_dms": 410,
"dm_replies": 225,
"ai_replies": 880,
"people_reached": 1190,
"ai_people": 402,
"handoffs": 31,
"credits_used": 612.4
},
"lifetime_runs": {
"comment_replies": 2210,
"comment_dms": 1630,
"dm_replies": 905,
"ai_replies": 3400
},
"automations_total": 6,
"automations_active": 4,
"by_type": {
"COMMENT_DM_FOLLOW": {
"total": 2,
"active": 2
},
"AI_DM_CONVERSATION": {
"total": 1,
"active": 1
}
},
"top_automations": [
{
"automation_id": "3d2f7a10-8c4b-4e1a-9b6d-2f8e1c5a7b90",
"name": "Price replies",
"automation_type": "COMMENT_DM_FOLLOW",
"status": "ACTIVE",
"period_delivered": 380,
"lifetime_runs": 1240,
"last_triggered_at": "2026-11-15T10:42:11+00:00"
}
]
}
}period_totals counts messages delivered in the period, grouped by kind; credits_used is AI credits. tracking is false (and period_totals null) until the event log was set up for the account.
curl -X GET 'https://api.chatverse.io/v1/instagram/top-posts?period=days_28' \
-H 'Authorization: Bearer YOUR_API_KEY'Response · 200
{
"success": true,
"message": "Top posts",
"data": {
"period": "days_28",
"scope": "period",
"posts": [
{
"id": "18012345678901234",
"caption": "Our summer collection is here ☀️",
"media_type": "CAROUSEL_ALBUM",
"is_reel": false,
"thumbnail_url": "https://scontent.cdninstagram.com/…",
"permalink": "https://www.instagram.com/p/C1a2b3c4/",
"timestamp": "2026-11-02T08:00:00+0000",
"likes": 1842,
"comments": 48,
"reach": 9120,
"saved": 210,
"shares": 64,
"engagement": 2164,
"has_comment_dm": true
}
]
}
}When nothing was posted in the period, the most recent posts are returned instead and scope says so. has_comment_dm: a Comment-to-DM automation already covers the post.