get_campaigns

What it does

Parameters

• date_preset string required

  Date preset for metrics

  One of today, yesterday, last_7d, last_14d, last_30d, last_90d, this_month, last_month

• ad_account_id string required

  Meta ad account id (act_…), from list_ad_accounts

  Matches ^(act_)?\d{1,32}$

• status_filter string optional

  Filter by campaign status

  One of all, active, paused

• limit number optional

  Max number of campaigns to return (default 25)

Example

Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_campaigns",
    "arguments": {
      "date_preset": "last_7d",
      "ad_account_id": "act_1234567890"
    }
  }
}

The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):

curl -X POST https://app.apogee.ad/mcp \
  -H "Authorization: Bearer $APOGEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_campaigns","arguments":{"date_preset":"last_7d","ad_account_id":"act_1234567890"}}}'

Access and cost

In the REST API

The same thing for your own code, with an API key:

• Get insights: GET /ad-accounts/{acc}/insights

Related tools

Performance: The same reads as Apogee's Autopilot, with the same numbers as the app. Ad names follow your naming convention: ask per concept or per hook.

• get_account_overview: Spend, impressions, clicks, CTR, CPC, ROAS and conversions of the ad account for a period.
• get_adsets: The ad sets with their targeting, budget and metrics.
• get_ads: The ads with their creative and metrics.
• get_top_performers: The best and the worst campaigns, ad sets or ads by ROAS, CPA, CTR or spend: what to scale, what to cut.
• get_daily_breakdown: Spend, ROAS, CPA and add to carts day by day.
• get_ad_performance_by_placement: Results by placement (Feed, Stories, Reels…).
• get_ad_performance_by_age_gender: Results by age and gender.
• get_ad_performance_by_device: Results by device.
• get_creative_fatigue_metrics: Frequency, CTR trend and CPC over time; flags tired creatives.
• get_video_metrics: Hook rate, hold rate, completion and ThruPlay per video ad.
• get_ad_creatives: The images, videos and texts of the ads of an ad set or a campaign.
• get_audience_insights: The targeting and estimated audience size of ad sets.
• get_account_spend_limit: The account's spend cap, amount spent and balance.
• get_campaign_budget_optimization: Whether a campaign uses a campaign budget (CBO), and that budget.