Developer Resources
REST API, MCP Server for AI agents, webhooks, and code examples.
Authentication
All API requests require an API key passed in the Authorization header.
Authorization: Bearer YOUR_API_KEYGenerate API keys from your account settings. Keys are scoped to your account and inherit your subscription tier limits.
REST API
Coming SoonProgrammatic access to your KatanaSEO data. Manage profiles, keywords, articles, and rankings via REST endpoints.
Features
- +Full CRUD for profiles, keywords, and articles
- +Ranking data and analytics endpoints
- +Webhook management
- +Rate limiting: 100 req/min (Pro), 500 req/min (Business)
Example
curl -X GET "https://api.katanaseo.com/v1/profiles" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"MCP Server (AI Agents)
BetaConnect AI agents like Claude, Cursor, and Windsurf to your SEO data via the Model Context Protocol.
Features
- +Query keyword research data from AI editors
- +Check article SEO scores and rankings
- +Trigger content generation from AI workflows
- +Compatible with Claude Desktop, Cursor, Windsurf
Example
{
"mcpServers": {
"katanaseo": {
"command": "npx",
"args": ["-y", "@katanaseo/mcp-server"],
"env": {
"KATANASEO_API_KEY": "your_api_key"
}
}
}
}Webhooks
ActiveReceive real-time notifications for job events. Connect KatanaSEO to any service.
Features
- +Events: job.started, job.progress, job.completed, job.failed
- +HMAC signature verification
- +Automatic retries with exponential backoff
- +Manage via dashboard or API
Example
// Webhook payload
{
"event": "job.completed",
"job_id": "abc123",
"profile_id": "def456",
"job_type": "article_generation",
"result": { "article_id": "ghi789", "seo_score": 87 }
}