ZuckerBot › Tool reference › Account audits & insights

Get Campaign Insights

zuckerbot_get_campaign_insights

Query campaign, ad set, or ad-level performance for any campaign in the connected Meta ad account — including campaigns not created by ZuckerBot. Tags each row with is_zuckerbot so you can benchmark ZuckerBot campaigns against manually managed ones. Supports date range filtering, campaign name search, status filters, time-series breakdowns, and multi-column sorting. For deduped truth use meta_result / cost_per_meta_result (Meta's Ads Manager "Results" for any objective) or conversion_leads / meta_leads — not the inflated, deprecated leads / cpl (the response's metric_semantics object labels every lead field). meta_result and conversion_leads are most reliable on campaign-level, non-time-incremented queries. Adset/ad rows report their OWN status — status_scope says which entity a row's status belongs to, statuses are as of status_synced_at, and refresh=true re-syncs them; spend-by-date is authoritative for whether delivery actually happened.

Parameters

Name	Type		Description
`business_id`	string	optional	Optional business ID override linked to the connected Meta ad account
`date_from`	string	optional	Optional start date in YYYY-MM-DD format. Defaults to 7 days ago.
`date_to`	string	optional	Optional end date in YYYY-MM-DD format. Defaults to today.
`campaign_ids`	string	optional	Optional comma-separated Meta campaign IDs
`search`	string	optional	Optional case-insensitive campaign name substring filter
`status`	string	optional	Optional status filter. Use active, paused, or all for the simple path, or pass legacy comma-separated values such as ACTIVE,PAUSED.
`level`	"campaign" \| "adset" \| "ad"	optional	Return campaign totals, ad set breakdowns, or ad breakdowns
`time_increment`	"daily" \| "monthly"	optional	Optional daily or monthly time-series breakdown
`sort`	string	optional	Optional sort field. Plain values sort descending; prefix with '+' for ascending. One of: spend, leads, cpl, meta_leads, conversion_leads, cpcl, meta_result, cpmr, results, cpr, ctr, impressions. Prefer meta_result / cpmr (Meta's deduped 'Results' for any objective) or conversion_leads / meta_leads over the deprecated, inflated leads / cpl.
`limit`	number	optional	Maximum campaigns to return after sorting
`refresh`	boolean	optional	Bypass the short-lived performance cache

Example call

{
  "tool": "zuckerbot_get_campaign_insights",
  "arguments": {}
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_get_campaign_insights and fills the arguments for you.

Related tools — Account audits & insights

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.