Integrations & SDKs
Every Kaonic Ai Beta capability is reachable over plain JSON. Where a wrapper makes the job easier, Kaonic ships one: a WordPress plugin for publishing sites, a dependency-free PHP SDK for SEO automation, and webhooks so your service hears about events instead of polling.
WordPress — the kaonic-seo plugin
The plugin connects a WordPress site to Kaonic so meta tags can be written and AI content published without leaving the terminal or your dashboard.
| Detail | Value |
|---|---|
| Plugin name | Kaonic SEO (kaonic-seo) |
| Version | 1.0.0 |
| Requires | WordPress 6.0+, PHP 8.0+ |
| Source folder | kaonic-mvp/wordpress-plugin/kaonic-seo |
| Settings page | Settings → slug kaonic-seo |
| Stored key option | kaonic_seo_api_key |
Install
- Copy the
kaonic-seofolder intowp-content/plugins/. - Activate Kaonic SEO in the WordPress admin. Activation generates a 48-character key automatically, so the site is ready to connect.
- Open the plugin settings page and copy the key (regenerate it there if it ever leaks).
- Give that key to Kaonic — for example as the API key of the site you register for SEO automation.
curl -X GET https://your-site.test/wp-json/kaonic/v1/ping \ -H "X-Kaonic-Key: <plugin key>"
{
"ok": true,
"plugin": "kaonic-seo",
"version": "1.0.0",
"site_name": "My Business",
"home_url": "https://your-site.test"
}
REST bridge
The plugin exposes a small namespace at /wp-json/kaonic/v1/. Every route is
guarded by the X-Kaonic-Key header, and an invalid key answers
401 kaonic_unauthorized.
| Route | Method | Purpose |
|---|---|---|
/wp-json/kaonic/v1/ping | GET | Connection test: plugin version, site name, home URL. |
/wp-json/kaonic/v1/meta | POST | Write meta_title and meta_description for the post behind a URL. |
/wp-json/kaonic/v1/content | POST | Create or update a post from Kaonic-generated title, body and meta. |
curl -X POST https://your-site.test/wp-json/kaonic/v1/meta \
-H "X-Kaonic-Key: <plugin key>" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-site.test/our-services",
"meta": {
"meta_title": "Solar Installation in Kampala | My Business",
"meta_description": "Certified solar installers serving Kampala and Entebbe."
}
}'
/meta resolves the URL to a post; if nothing matches it answers
404 kaonic_post_not_found. /content creates the post as a draft
unless you send "status": "publish".
PHP SDK — kaonic/seo-sdk
A thin, dependency-free HTTP client for the Kaonic SEO surface (keywords, content,
competitors, trends, recommendations, automation and WordPress). It needs only
ext-curl and ext-json.
| Detail | Value |
|---|---|
| Package | kaonic/seo-sdk |
| Requires | PHP 8.1+ |
| Autoload | PSR-4 — Kaonic\ → src/ |
| Source folder | kaonic-mvp/sdk/php |
Install
Add the SDK to your project with a Composer path or VCS repository pointing at
kaonic-mvp/sdk/php, then require it:
composer require kaonic/seo-sdk
Use
<?php
require __DIR__ . '/vendor/autoload.php';
use Kaonic\KaonicClient;
$kaonic = new KaonicClient(
'https://ai.gatavase.com',
getenv('KAONIC_API_KEY'), // GK_… private key or bearer token
['timeout' => 30]
);
$sites = $kaonic->sites->list();
echo json_encode($sites, JSON_PRETTY_PRINT);
The client exposes one property per resource group:
| Property | Covers |
|---|---|
$kaonic->sites | Connected websites. |
$kaonic->keywords / $kaonic->globalKeywords | Keyword research and tracking. |
$kaonic->content | AI content generation and publishing. |
$kaonic->competitors / $kaonic->trends | Competitor and trend analysis. |
$kaonic->recommendations | Optimisation opportunities. |
$kaonic->automation | Autonomous optimisation runs. |
$kaonic->wordpress | Talking to a connected WordPress site. |
$kaonic->multilingual | African-language content. |
Webhooks
Subscribe an HTTPS endpoint and Kaonic posts to it when something happens, instead of you
polling. Create a webhook with a name, a URL and one or more supported events; Kaonic answers
with a signing secret (whsec_…) that is shown once.
| Event | Fires when |
|---|---|
seo.audit.completed | An SEO audit for a connected site finishes. |
agent.message.completed | The AI agent completes a message or briefing. |
- Endpoints must be publicly reachable over HTTPS.
- Secrets are encrypted at rest and never returned again — store yours immediately.
- Webhooks can be toggled off without deleting them, and a test delivery can be triggered from the developer portal.
- Creation is rate limited to 30 changes per 5 minutes.
Any other stack
If there is no wrapper for your language, the REST API is the integration. Send
X-Kaonic-Key with a private GK_… key and read JSON back:
curl -X POST https://www.ai.gatavaseug.com/api/v1/chat \
-H "Content-Type: application/json" \
-H "X-Kaonic-Key: $KAONIC_API_KEY" \
-d '{"message":"Draft a WhatsApp promotion for my restaurant","conversation_id":null}'
Next steps
- Kaonic CLI & engine — install and run the stack from the terminal.
- API keys & auth — issue the key these integrations use.
- Endpoint reference — the full route list.