| Client | Agent | Action | Frequency | Next Run | Status | |
|---|---|---|---|---|---|---|
| No schedules configured | ||||||
Loading...
| Agent | Cost | Tokens |
|---|---|---|
| No data yet | ||
Swap API providers without touching code. Changes apply on next restart.
| Service | Available Providers | Env Variable |
|---|---|---|
| LLM Engine | anthropic, openai, google | LLM_PROVIDER |
| SERP Search | serper, dataforseo_serp | SERP_PROVIDER |
| SEO Data | dataforseo | SEO_DATA_PROVIDER |
| Plagiarism | copyscape | PLAGIARISM_PROVIDER |
| Crawler | builtin | CRAWLER_PROVIDER |
| CMS | wordpress, shopify, static | CMS_PROVIDER (per-client via cms_type) |
| Analytics | ANALYTICS_PROVIDER |
| Title | Client | Type | Target Keyword | Status | Created | |
|---|---|---|---|---|---|---|
| Loading content... | ||||||
| Client | Type | Score | Issues | Date | |
|---|---|---|---|---|---|
| Loading audits... | |||||
| Competitor Domain | Client | Tracked Since | |
|---|---|---|---|
| Loading competitors... | |||
| Source | Target | DA | Status |
|---|---|---|---|
| Select a client to view backlinks | |||
Estimate monthly API costs based on deliverables. Add tasks the client needs, set quantities and frequency.
Complete reference for The SEO Den REST API. All endpoints require an Authorization: Bearer <token> header unless noted.
/api/auth/register
Register a new organization and admin user. No auth required.
curl -X POST https://your-domain/api/auth/register \
-H "Content-Type: application/json" \
-d '{"name":"Jane","email":"jane@agency.com","password":"secret","org_name":"My Agency"}'/api/auth/login
Authenticate and receive a JWT token.
curl -X POST https://your-domain/api/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"jane@agency.com","password":"secret"}'/api/auth/me
Get the currently authenticated user and organization info.
curl https://your-domain/api/auth/me \
-H "Authorization: Bearer YOUR_TOKEN"/api/clients
List all clients for your organization.
curl https://your-domain/api/clients \
-H "Authorization: Bearer YOUR_TOKEN"/api/clients
Create a new client with domain, industry, and location.
curl -X POST https://your-domain/api/clients \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Sunrise Jewellers","domain":"sunrisejewellers.com","industry":"jewellers","location":"Mumbai"}'/api/clients/{id}
Get detailed info for a specific client by ID.
curl https://your-domain/api/clients/CLIENT_ID \
-H "Authorization: Bearer YOUR_TOKEN"/api/tasks
List all tasks with optional status and agent filters.
curl "https://your-domain/api/tasks?status=pending&agent=content" \
-H "Authorization: Bearer YOUR_TOKEN"/api/chat
Send a natural language command to the agent system (Command Center interface).
curl -X POST https://your-domain/api/chat \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message":"Run a full SEO audit for sunrisejewellers.com"}'/api/rankings?client_id=X&days=30
Get keyword ranking data for a client over a given time period.
curl "https://your-domain/api/rankings?client_id=CLIENT_ID&days=30" \
-H "Authorization: Bearer YOUR_TOKEN"/api/content
List all generated content pieces with status and metadata.
curl https://your-domain/api/content \
-H "Authorization: Bearer YOUR_TOKEN"/api/content/{id}
Get a specific content piece including full HTML body.
curl https://your-domain/api/content/CONTENT_ID \
-H "Authorization: Bearer YOUR_TOKEN"/api/content/{id}
Update content status, title, or body.
curl -X PUT https://your-domain/api/content/CONTENT_ID \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"status":"approved","title":"Updated Title"}'/api/reports
List all generated reports for your organization.
curl https://your-domain/api/reports \
-H "Authorization: Bearer YOUR_TOKEN"/api/reports/{id}/html
Get the full HTML version of a report (white-label ready).
curl https://your-domain/api/reports/REPORT_ID/html \
-H "Authorization: Bearer YOUR_TOKEN"/api/reports/{id}/pdf
Download the PDF version of a report.
curl -o report.pdf https://your-domain/api/reports/REPORT_ID/pdf \
-H "Authorization: Bearer YOUR_TOKEN"/api/bulk/import-keywords
Import a list of keywords for tracking across one or more clients.
curl -X POST https://your-domain/api/bulk/import-keywords \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"client_id":"CLIENT_ID","keywords":["gold jewellery mumbai","diamond rings online"]}'/api/bulk/audit
Trigger SEO audits for multiple clients at once.
curl -X POST https://your-domain/api/bulk/audit \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"client_ids":["ID_1","ID_2"],"audit_type":"full"}'/api/bulk/content
Queue content generation for multiple topics or clients in batch.
curl -X POST https://your-domain/api/bulk/content \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"client_id":"CLIENT_ID","topics":["best gold jewellery designs 2026","how to choose diamond rings"]}'/api/webhooks
List all configured webhook endpoints for your organization.
curl https://your-domain/api/webhooks \
-H "Authorization: Bearer YOUR_TOKEN"/api/webhooks
Register a new webhook to receive event notifications (task.completed, audit.done, content.ready).
curl -X POST https://your-domain/api/webhooks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url":"https://your-app.com/hooks/seo","events":["task.completed","content.ready"]}'/api/billing/plans
List available subscription plans and pricing tiers.
curl https://your-domain/api/billing/plans \
-H "Authorization: Bearer YOUR_TOKEN"/api/billing/usage
Get current billing period usage including API calls, content generated, and audits run.
curl https://your-domain/api/billing/usage \
-H "Authorization: Bearer YOUR_TOKEN"