Get Insights
LIVE performance insights straight from the Meta Graph API (impressions, clicks, spend, CTR, CPC, actions) for a campaign, ad set, ad, or account. Supports date presets, custom date ranges, breakdowns, and custom field selection.
If reporting-warehouse tools are available to you in this session (get_top_creatives_data, get_campaign_spend, get_account_summary, query_reporting), this tool is the fallback, not the default. Use it only for what the warehouse cannot answer: today and the last 24h, or a breakdown it does not carry. Ranking ads or campaigns over a past period (‘which ads should I kill/scale’, ‘top creatives’), multi-day totals, and week- or month-over-month trends all belong to the warehouse — it aggregates in SQL, answers for every object in one call, and returns a ranked handful of rows instead of one row per object.
This tool returns one raw JSON row per object per time bucket, each carrying full actions and cost_per_action_type arrays. At level: 'ad' over a multi-day range that is tens of thousands of tokens — enough to fill your context and truncate your own answer. If you call it anyway, narrow it: the smallest limit that answers the question, an explicit fields list, and one call with time_increment rather than one call per period.
The response is capped in size. Past that, rows are dropped and a truncation object says how many — the rows you get back are an arbitrary page, NOT the top performers, because this endpoint returns no ranking. summary is always computed over every fetched row, so totals and averages stay correct even when rows are dropped. If you see truncation, do not rank from what remains: ask the warehouse.
Authorizations
API key (sk_live_*) — SHA256 hashed, looked up in Redis. Generate via the web app's workspace settings.