get_reel_analytics
Per-post performance for every reel/post/carousel published in a date range: views, reach, likes, comments, saves, shares, average watch time (reels only), caption, permalink, thumbnail, and whether it used AI-generated caption/hashtags. This is the tool for "how did my last N days of reels do" / "list my reel details" style questions — it returns one item per published post, newest first, not just a rollup.
Includes posts published natively on Instagram (not just ones scheduled
through reeldrop) — check each item's `source` field ("reeldrop" vs
"instagram"). Excludes stories — use get_story_analytics for those.
Feed posts and carousels also carry `profile_activity`: what people did
on the profile after seeing the post (bio_link_clicked, call, direction,
email, text, other, total), plus `bio_link_taps` as a shortcut. Sort by
`bio_link_taps` to answer "which post sent people to my link in bio".
Both are null for reels, because Instagram doesn't report this metric for
them, and for posts whose insights haven't been refreshed since it was added.Two ways to pick the window, pick exactly one style per call:
days: an integer count ending today, in the workspace's own local time — e.g. days=50 for "the last 50 days". Preferred for relative asks ("last N days", "this month so far") since it does the date math correctly against the account's own clock instead of you computing it.
since/until: explicit "YYYY-MM-DD" bounds (inclusive), in the workspace's own timezone (list_workspaces/get_posting_slots show it) — for a specific calendar window ("August 1 to August 15"). Passing days together with since/until is rejected as ambiguous. Omitting all three defaults to the last 30 days.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "get_reel_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| since | No | ||
| until | No | ||
| workspace_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| range | Yes | The window a response was actually built for. Always echoed so a caller labels the numbers from what came back, not from request state — the 90-day clamp and the cache can both make those differ. |