Ads Optimizer

Manage and optimize advertising campaigns with AI-driven analysis. Run performance audits, get optimization recommendations, manage A/B tests, and detect spending anomalies before they burn budget. Built for AI agents that manage paid media on behalf of clients.

Authentication

All endpoints require x402 payment (USDC on Base L2). Send a request without payment to receive pricing info in the 402 response.

Endpoints

Manage Campaigns

• Method: POST
• Path: /api/ads/campaigns
• Price: $0.05 per call
• Description: Create or update an ad campaign configuration. Tracks platform, budget, targeting, and creative details.

Request:

{
  "name": "HVAC Dallas - Search",
  "platform": "google-ads",
  "type": "search",
  "daily_budget": 50.00,
  "targeting": {
    "location": "Dallas, TX",
    "radius_miles": 25,
    "keywords": ["hvac repair near me", "ac installation dallas", "heating repair"],
    "negative_keywords": ["diy", "how to"]
  },
  "bid_strategy": "maximize-conversions",
  "landing_page": "https://comfortzonehvac.com/schedule"
}

Response:

{
  "id": "camp_3x8rp4",
  "name": "HVAC Dallas - Search",
  "platform": "google-ads",
  "status": "active",
  "daily_budget": 50.00,
  "created_at": "2026-04-01T15:00:00Z"
}

Run Audit

• Method: POST
• Path: /api/ads/audits
• Price: $0.50 per call
• Description: Run a full AI audit on a campaign. Analyzes spend efficiency, keyword performance, audience targeting, creative fatigue, and competitor positioning.

Request:

{
  "campaign_id": "camp_3x8rp4",
  "date_range": {
    "start": "2026-03-01",
    "end": "2026-03-31"
  },
  "include_competitor_analysis": true
}

Response:

{
  "audit_id": "aud_9m2kf7",
  "campaign_id": "camp_3x8rp4",
  "overall_score": 72,
  "spend_total": 1550.00,
  "conversions": 31,
  "cost_per_conversion": 50.00,
  "findings": [
    {"severity": "high", "area": "keywords", "finding": "3 keywords consuming 40% of budget with zero conversions", "action": "pause-keywords"},
    {"severity": "medium", "area": "bidding", "finding": "CPC 23% above industry average for HVAC", "action": "adjust-bids"},
    {"severity": "low", "area": "creative", "finding": "Ad copy unchanged for 45 days, CTR declining", "action": "refresh-creative"}
  ],
  "estimated_savings_monthly": 320.00
}

Optimization Analysis

• Method: POST
• Path: /api/ads/optimization/analyze
• Price: $0.25 per call
• Description: Get specific optimization recommendations for a campaign. Returns actionable changes with projected impact.

Request:

{
  "campaign_id": "camp_3x8rp4",
  "optimization_goal": "lower-cpa",
  "constraints": {
    "min_daily_budget": 30.00,
    "max_daily_budget": 75.00
  }
}

Response:

{
  "recommendations": [
    {
      "action": "pause-keywords",
      "targets": ["hvac repair near me", "heating system cost"],
      "reason": "High spend, zero conversions in 30 days",
      "projected_savings": "$210/mo"
    },
    {
      "action": "increase-bid",
      "targets": ["ac installation dallas"],
      "reason": "Top performer, currently losing impression share",
      "projected_impact": "+8 conversions/mo"
    },
    {
      "action": "add-negative-keywords",
      "targets": ["free", "cost of", "average price"],
      "reason": "Informational queries burning budget",
      "projected_savings": "$85/mo"
    }
  ],
  "projected_new_cpa": 38.50,
  "projected_improvement": "23%"
}

Manage A/B Tests

• Method: POST
• Path: /api/ads/tests
• Price: $0.10 per call
• Description: Create and track A/B tests on ad creative, landing pages, or bidding strategies.

Request:

{
  "campaign_id": "camp_3x8rp4",
  "test_type": "ad-copy",
  "variant_a": {
    "headline": "Top-Rated HVAC Repair in Dallas",
    "description": "Same-day service. Licensed technicians. Call now."
  },
  "variant_b": {
    "headline": "AC Broken? Dallas Experts On Call",
    "description": "4.8 stars, 500+ reviews. Book online in 30 seconds."
  },
  "traffic_split": 50,
  "duration_days": 14,
  "success_metric": "conversion-rate"
}

Response:

{
  "id": "test_5k7nw2",
  "campaign_id": "camp_3x8rp4",
  "status": "running",
  "start_date": "2026-04-01",
  "end_date": "2026-04-15",
  "traffic_split": "50/50"
}

Detect Anomalies

• Method: GET
• Path: /api/ads/anomalies
• Price: $0.10 per call
• Description: Scan campaigns for spending anomalies, sudden performance drops, or suspicious click patterns.

Request:

GET /api/ads/anomalies?campaign_id=camp_3x8rp4&lookback_days=7

Response:

{
  "anomalies": [
    {
      "type": "spend-spike",
      "severity": "high",
      "detected_at": "2026-03-29T08:00:00Z",
      "details": "Daily spend jumped 340% ($50 to $220) due to broad match keyword expansion",
      "recommended_action": "Review and restrict match types"
    },
    {
      "type": "ctr-drop",
      "severity": "medium",
      "detected_at": "2026-03-30T12:00:00Z",
      "details": "CTR dropped 45% on headline variant A, possible ad fatigue",
      "recommended_action": "Rotate creative"
    }
  ]
}

Use Cases

• A media buying agent audits client campaigns monthly and implements optimizations
• An autonomous budget guardian monitors for anomalies and pauses runaway spend
• A creative agent runs A/B tests on ad copy and reports winning variants
• An analytics agent produces monthly performance reports with actionable insights
• A sales agent includes ad optimization as part of a managed services package

Pricing