OKIZA AI CMO•API Documentation & Webhooks

Build on Okiza API

Trigger autonomous audits, pull ready-to-ship fixes, and subscribe to real-time marketing pipeline webhooks directly from your terminal or CI/CD.

Authentication

Authenticate all requests using standard Bearer API tokens generated in your workspace settings.

Trigger Audits

Initiate on-demand crawls of technical SEO, backlinks, and AI search visibility (GEO).

Webhooks & PRs

Listen for daily ready-to-ship fixes or automated GitHub pull request generation events.

POST/v1/audit/trigger

Launches an asynchronous audit of your domain's technical health and AI engine citation footprint.

Request Example (bash)
curl -X POST https://api.okiza.com/v1/audit/trigger \
  -H "Authorization: Bearer okz_live_948f92bd84729" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourcompany.com",
    "include_geo": true,
    "engines": ["chatgpt", "perplexity", "claude", "gemini"]
  }'
200 OK • Response Payload
{
  "status": "success",
  "audit_id": "aud_88319f0a2",
  "domain": "yourcompany.com",
  "health_score": 86,
  "geo_visibility_score": 79,
  "daily_fixes": [
    {
      "id": "fix_01",
      "type": "technical_schema",
      "priority": "critical",
      "title": "Add JSON-LD SoftwareApplication schema to pricing page",
      "impact": "+14% expected LLM citation boost",
      "ready_patch": "<script type=\"application/ld+json\">...</script>"
    },
    {
      "id": "fix_02",
      "type": "geo_keyword_gap",
      "priority": "high",
      "title": "Missing Perplexity citation query for 'AI CMO automation'",
      "impact": "Top 3 answer placement opportunity",
      "ready_patch": "Recommended draft article ready for approval"
    }
  ]
}
WEBHOOKaudit.completed

Dispatched automatically when daily technical crawls finish and new code patches or articles are ready for review.

Webhook JSON Payload
{
  "event": "audit.completed",
  "timestamp": 1731302400,
  "data": {
    "domain": "yourcompany.com",
    "score": 88,
    "critical_count": 0,
    "fixes_generated": 2,
    "pr_url": "https://github.com/your-org/web/pull/142"
  }
}

Need an API token or sandbox environment?

Get your live and test keys directly from the Okiza dashboard during your 7-day free trial.