!

API documentation

Use this reference to integrate website analysis, streaming job updates, and content generation with Automate My Blog. Paths below match the production/staging Node API router.
Free analysis · No credit card required
See platform features
Core endpoints
MethodEndpointPurposeAuth
GET/healthLiveness probe on the API host (same deployment as /api/v1/*)Public
GET/readyReadiness probe (Postgres SELECT 1; 503 when DB unavailable)Public
GET/apiMachine-readable map of documented routes and descriptionsPublic
POST/api/v1/auth/loginEmail/password login; sets HttpOnly session cookie for browser clientsPublic
GET/api/v1/auth/meCurrent user and organization contextSession or JWT
POST/api/v1/session/createAnonymous session id for onboarding before signupPublic
GET/api/v1/public-site/:publicUsernameRead published hosted landing HTML + theme (no auth when hosting is enabled)Public
POST/api/v1/prospect-audit/publicRate-limited public SEO audit from a URL (returns slug/path for /seo-audit/:slug)Public (rate limited)
POST/api/v1/jobs/website-analysisEnqueue async website analysis (returns jobId)Session, JWT, or x-session-id
GET/api/v1/jobs/:jobId/statusPoll job status and result payload when terminalSession, JWT, or x-session-id
GET/api/v1/jobs/:jobId/narrative-streamServer-sent events for analysis narration / progressSession, JWT, or x-session-id
GET/api/v1/jobs/:jobId/streamServer-sent events for per-item partial results (audiences, blog chunks, etc.)Session, JWT, or x-session-id
POST/api/v1/jobs/content-generationEnqueue async enhanced blog generation (worker + credits)Session, JWT, or x-session-id
GET/api/v1/stream/:connectionIdEphemeral SSE for generate-stream endpoints (topics, tweets, blog, etc.)Session, JWT, or x-session-id
POST/api/v1/topicsGenerate topic suggestions for a selected audienceSession optional (see backend optionalAuth)
POST/api/v1/enhanced-blog-generation/generateDeprecated — returns 410. Use POST /api/v1/jobs/content-generationSession or JWT
POST/api/v1/blog-posts/custom-generateDeprecated — returns 410. Use POST /api/v1/jobs/content-generationSession or JWT
GET/api/v1/blog-postsList authenticated user blog postsSession or JWT
Webhook events
  • Product webhooks (content.ready / publish.completed style) are not a separate public contract today.
  • Prefer jobs + status + narrative-stream / stream for durable integration; confirm any webhook program with support before building to these names.
Integration guide
  • 1. Optional: POST /api/v1/session/create for anonymous onboarding, then send x-session-id on job routes until the user signs up.
  • 2. Authenticate (HttpOnly session cookie after POST /api/v1/auth/login, or Authorization: Bearer …; job routes also accept x-session-id).
  • 3. POST /api/v1/jobs/website-analysis with { url } → jobId; poll GET /api/v1/jobs/:jobId/status until succeeded or failed.
  • 4. While the job runs, open GET /api/v1/jobs/:jobId/narrative-stream and/or GET /api/v1/jobs/:jobId/stream (SSE) for live progress and partial results.
  • 5. For topics, POST /api/v1/topics with audience + organization context as used in the dashboard, or use POST …/generate-stream + GET /api/v1/stream/:connectionId.
  • 6. For posts, use POST /api/v1/jobs/content-generation (async worker + SSE). Sync paths (/enhanced-blog-generation/generate, /blog-posts/custom-generate) are deprecated and return 410 unless ALLOW_SYNC_GENERATE=1 on the server.
  • 7. For a no-auth SEO audit demo, POST /api/v1/prospect-audit/public with { url } (rate limited) or use the /seo-audit page on the marketing site.
Explore:
Features
Pricing
Free SEO audit
Why Not ChatGPT
Why Not Claude
Client Growth Playbook
API Docs
Zoom
Support
Privacy
Terms