Meta Ads / API Reference
meta_ads_instagram_insights
Meta Ads tool. Get insights/analytics for an Instagram Business account linked to a Facebook Page. Args: instagram_account_id: Instagram Business Account ID (required). metric: Comma-separated metrics: views, reach, follower_count, profile_views, email_contacts, phone_call_clicks, website_clicks. Default views,reach,follower_count,profile_views. Meta removed `impressions` for Instagram on 2025-04-21 and replaced it with `views`; passing it is rewritten to `views` rather than failing. period: 'day', 'week', 'month', or 'lifetime'. Default day. start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. page_access_token: Page access token, required -- take it from the `access_token` field of meta_ads_pages. There is no user-token fallback.
This is a read-only tool: it returns instagram insights for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Instagram insights in my Meta Ads account for [instagram account id].
It takes 1 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
instagram_account_id | string | Yes | Instagram Account Id |
metric | string | No | Metric |
period | string | No | Period |
start_date | string | No | Start Date |
end_date | string | No | End Date |
page_access_token | string | No | Page Access Token |
Related Meta Ads tools
meta_ads_instagram_accountmeta_ads_instagram_competitor_analysismeta_ads_instagram_hashtag_postsmeta_ads_instagram_mediameta_ads_instagram_mentionsmeta_ads_instagram_post_insights
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account:
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.