API Documentation

Complete API reference for all DeepDiligence services

API responses and documentation are provided “as is” without warranty and may include user-generated or AI-derived material. Not financial advice.

Important: API Usage Rules

✅ DO: Use Next.js API routes (/api/*) from React components
❌ Don't: Call backend services directly from the frontend
✅ Example: fetch('/api/ticker-history')
❌ Wrong: fetch('http://localhost:3001/api/documents')

Frontend API Routes

PRIMARY

Port: 3003 | Next.js API routes - Use these from React components

GET/api/ticker-historyGet version history

GET/api/master-reportGet master report

GET/api/report-diffCompare versions

Document API

BACKEND

Port: 3001 | Document versioning and storage service

GET/api/documentsList documents

GET/api/documents/:id/versionsGet versions

GET/api/documents/:id/diffCompare versions

Swagger Docs OpenAPI Spec

Main Backend

LEGACY

Port: 3000 | Original backend API for workflows

POST/api/submit-contributionSubmit research

GET/api/list-reportsList all reports

GET/api/contributionsGet contributions

Scraper Service

PYTHON

Port: 8001 | Web scraping and content extraction

POST/scrapeScrape URL

POST/gemini/convertConvert to report

GET/healthHealth check

Architecture & Data Flow

Frontend (React/Next.js :3003)
    ↓
    calls → /api/ticker-history
    ↓
Next.js API Route (proxy layer)
    ↓
    calls → http://localhost:3001/api/documents
    ↓
Document API (:3001)
    ↓
    returns → Version history data
    ↓
Back to Frontend → Renders in UI

Quick Start Commands:

# Terminal 1: Document API
cd my-crucible-app/services/document-api && npm run dev

# Terminal 2: Main Backend
cd my-crucible-app && npm run dev

# Terminal 3: Frontend
cd Moho/my-app && npm run dev:3003