MITPO AssistantDevelopers

API Reference

Complete documentation for the MITPO Universal API

Base URL

https://api.mitpo.io

AI Endpoints

Generate campaign-ready copy, run competitive analysis, and get optimization suggestions that support launch planning, diagnostics, and ongoing campaign operations.

POST/v1/ai/generate2 credits

Generate marketing copy for launch planning, creative iteration, and channel-specific campaign execution.

ParameterTypeDescription
type *enumad_copy, social_caption, headline, or email_subject
brief *stringCreative brief (1-2000 characters)
platformstringTarget platform for format optimization
tonestringDesired tone (e.g. professional, casual, bold)
countintegerNumber of variations (1-5, default 3)
Request
curl -X POST https://api.mitpo.io/v1/ai/generate \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social_caption",
    "brief": "Launch announcement for a new unified marketing API platform",
    "platform": "linkedin",
    "tone": "professional",
    "count": 3
  }'
Response 200
{
  "success": true,
  "data": {
    "generations": [
      {
        "text": "MITPO gives growth teams one control plane to plan, launch, and monitor campaigns across channels without stitching together provider tooling.",
        "platform_ready": true
      },
      {
        "text": "Stop treating campaign execution like a spreadsheet and three dashboards. MITPO turns launches into a managed operational workflow.",
        "platform_ready": true
      },
      {
        "text": "Introducing MITPO — the campaign operations platform with an API layer for dispatches, connections, webhooks, and AI-assisted execution.",
        "platform_ready": true
      }
    ]
  },
  "request_id": "req_ai1a2b3c..."
}
POST/v1/ai/analyze5 credits

Run competitor, market, or positioning analysis with optional web search.

ParameterTypeDescription
type *enumcompetitor, market, or positioning
urlstringTarget URL for competitor analysis
query *stringAnalysis query or prompt (1-2000 characters)
Request
curl -X POST https://api.mitpo.io/v1/ai/analyze \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "competitor",
    "url": "https://example.com",
    "query": "Analyze their positioning and market strategy in the marketing automation space"
  }'
Response 200
{
  "success": true,
  "data": {
    "analysis": {
      "summary": "Example.com positions itself as an enterprise-grade marketing automation suite...",
      "strengths": ["Strong brand recognition", "Comprehensive feature set"],
      "weaknesses": ["Complex onboarding", "Premium pricing limits SMB adoption"],
      "opportunities": ["API-first competitors gaining traction", "Growing demand for unified platforms"]
    }
  },
  "request_id": "req_ai4d5e6f..."
}
POST/v1/ai/optimize3 credits

Get AI-powered campaign optimization suggestions based on goals and performance metrics.

ParameterTypeDescription
channel *stringAd channel (e.g. meta_ads, google_ads)
goal *stringOptimization goal description
metricsobjectCurrent performance metrics (ctr, cpc, cpa, impressions, etc.)
campaign_idstringExisting campaign ID for context-aware suggestions
Request
curl -X POST https://api.mitpo.io/v1/ai/optimize \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "meta_ads",
    "goal": "Improve click-through rate and reduce cost per acquisition",
    "metrics": {
      "ctr": 0.8,
      "cpc": 2.50,
      "cpa": 45.00,
      "impressions": 50000
    }
  }'
Response 200
{
  "success": true,
  "data": {
    "suggestions": [
      {
        "category": "creative",
        "priority": "high",
        "recommendation": "Test video creatives — Meta reports 2-3x higher CTR for video vs. static images in your vertical."
      },
      {
        "category": "targeting",
        "priority": "medium",
        "recommendation": "Narrow your lookalike audience from 5% to 2% to improve relevance and reduce CPA."
      },
      {
        "category": "bidding",
        "priority": "medium",
        "recommendation": "Switch from lowest-cost to cost-cap bidding with a $35 CPA target to control acquisition costs."
      }
    ],
    "projected_impact": {
      "ctr_change": "+40-60%",
      "cpa_change": "-15-25%"
    }
  },
  "request_id": "req_ai7g8h9i..."
}

Ready to automate campaign operations?

Get an API keyTry the Playground