# AITF API

> Agent-Ready Business Execution API. 15 products, 45 endpoints.
> AI agents call this API to automate marketing workflows: content, email, video, chatbot, security, and more.

## Documentation
- [API Reference (OpenAPI)](https://aitf-api.onrender.com/openapi.json)
- [Interactive Simulator](https://aitf-api.onrender.com/portal/simulator.html)
- [Usage Dashboard](https://aitf-api.onrender.com/portal/dashboard.html)
- [Product Portal](https://aitf-api.onrender.com/portal/)

## Getting Started
- Register for free API key: `POST /v1/auth/register` with `{"email": "you@example.com"}`
- All endpoints require `X-API-KEY` header
- Free plan: 1,000 calls/month

## API Products

### Content Engine
- `POST /v1/content/generate` — Generate blog, SNS, email, shorts, newsletter in 7 languages
- `GET /v1/content/types` — List available content types
- `GET /v1/content/languages` — List supported languages
- `GET /v1/content/jobs/{job_id}` — Get generation result

### Comment Shield
- `POST /v1/comments/analyze` — Sentiment analysis on comments
- `POST /v1/comments/reply` — AI-generated replies
- `POST /v1/comments/batch` — Batch analysis

### Trend Radar
- `POST /v1/trends/scan` — Scan trending keywords
- `GET /v1/trends/top` — Get top trends

### Blog Publisher
- `POST /v1/blog/publish` — Generate SEO-optimized blog post
- `GET /v1/blog/templates` — List blog templates

### Email Sequence
- `POST /v1/email/sequence` — Generate 7-day nurturing email sequence
- `POST /v1/email/single` — Generate single email
- `GET /v1/email/templates` — List email templates

### Video Script
- `POST /v1/video/script` — Generate shorts/longform video script
- `POST /v1/video/hooks` — Generate hook variations
- `GET /v1/video/templates` — List video templates

### Chatbot
- `POST /v1/chatbot/message` — Send message to custom chatbot
- `POST /v1/chatbot/configure` — Configure chatbot system prompt

### Security Guard
- `POST /v1/security/audit` — OWASP security audit on code
- `POST /v1/security/scan` — Scan for vulnerabilities
- `GET /v1/security/standards` — List security standards

### Usage Monitor
- `POST /v1/monitor/check` — Check current API usage
- `POST /v1/monitor/alert` — Set usage threshold alerts
- `GET /v1/monitor/history` — Usage history (daily/weekly/monthly)
- `POST /v1/monitor/forecast` — AI cost forecast

### Voice TTS
- `POST /v1/voice/tts` — Text-to-speech via ElevenLabs
- `GET /v1/voice/voices` — List available voices
- `GET /v1/voice/jobs/{job_id}` — Get TTS result

### Ops Report
- `POST /v1/reports/generate` — Generate business report
- `GET /v1/reports/templates` — List report templates

### Workflow Engine
- `POST /v1/workflow/run` — Execute multi-step workflow
- `GET /v1/workflow/status/{id}` — Check workflow status
- `POST /v1/workflow/approve/{id}` — Approve pending workflow

### Billing
- `POST /v1/billing/checkout` — Create checkout session
- `GET /v1/billing/subscription` — Get subscription status
- `POST /v1/billing/usage` — Get usage-based billing
- `POST /v1/billing/webhook` — Receive payment events

### Webhooks
- `POST /v1/webhooks/subscribe` — Subscribe to events
- `GET /v1/webhooks/list` — List subscriptions
- `DELETE /v1/webhooks/{id}` — Unsubscribe
- `POST /v1/webhooks/test` — Test webhook delivery

### Auth
- `POST /v1/auth/register` — Register and get API key
- `POST /v1/auth/verify` — Verify API key
- `GET /v1/auth/usage` — Check usage quota

## Pricing
- Free: 1,000 calls/month (no credit card)
- Starter ($19/mo): 5,000 calls/month
- Growth ($49/mo): 20,000 calls/month
- Pro ($149/mo): Unlimited

## MCP Integration
Install via: `npx -y @aitf/mcp-server`
Configure in claude_desktop_config.json with your AITF_API_KEY.

## Contact
- Website: https://aitf-api.onrender.com
- GitHub: https://github.com/aiaijungle/aitf-api