Developer Docs
API Reference
REST API for CatyAI's full infrastructure stack — conversations, knowledge base, GEO Gateway, FraudAI Shield, and analytics.
Full interactive docs coming soon · v1.0
Authentication
All API requests require a Bearer token from your dashboard.
Authorization: Bearer YOUR_API_KEY
Base URL: https://api.catyai.io
Endpoints
Preview of available endpoints. Full SDK documentation with request/response schemas, rate limits, and code examples is in progress.
GET
/answer
AI-to-AI machine-readable endpoint. Returns structured JSON-LD with business data for AI engines.
GEO Gateway
GET
/llms.txt
AI truth document served at domain root. Indexed by GPTBot, ClaudeBot, PerplexityBot.
GEO Gateway
POST
/v1/conversation
Send a message to the AI assistant and receive a response. Supports text, media, and structured payloads.
Core
GET
/v1/conversations
List all conversations with optional filters: date range, status, channel.
Core
POST
/v1/knowledge
Upload documents to the AI knowledge base. Accepts PDF, DOCX, TXT, CSV.
Knowledge
GET
/v1/analytics
Retrieve conversation analytics: volume, resolution rate, peak hours, top intents.
Analytics
GET
/v1/fraud/log
Retrieve the FraudAI quarantine log. Shows blocked messages with threat classification.
FraudAI
POST
/v1/geo/audit
Run a GEO score audit on a domain. Returns visibility score across 9 AI crawlers.
GEO Gateway