ZuckerBot › Tool reference › Account audits & insights

Analyse Account History

zuckerbot_analyse_account_history

Analyse the historical ad performance for a business. For accounts WITH history: returns aggregated metrics by audience type, top performing creatives, and comparable CPL ranges. For NEW accounts with NO history: returns is_cold_start=true with industry benchmarks. Use this as the FIRST step in campaign planning — feed the result into zuckerbot_recommend_campaign_structure.

Parameters

Name	Type		Description
`business_id`	string	optional	Business ID (auto-resolved from API key if omitted)
`lookback_days`	number	required	Number of days of history to analyse (default: 90)
`include_audience_history`	boolean	required	Include analysis of which audiences have been targeted before
`target_audience`	string	optional	Optional audience keyword to check if it has been targeted before (e.g., 'pool builders')

Example call

{
  "tool": "zuckerbot_analyse_account_history",
  "arguments": {
    "lookback_days": 123,
    "include_audience_history": true
  }
}

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_analyse_account_history 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.