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.