MarketGeist API-first Docs

All intelligence outputs are JSON-first and machine-consumable for integrations. Authenticate with your Clerk bearer token.

Core Intelligence Endpoints

POST/api/v1/reportsCreate decision-ready market brief from a prompt
GET/api/v1/reportsList user reports
GET/api/v1/reports/{id}Get full report details
GET/api/v1/reports/opportunity-score/{id}Get score + confidence for a report
POST/api/v1/competitorsAdd competitor tracking target
GET/api/v1/competitorsList tracked competitors + recent events
POST/api/v1/alertsCreate alert rule
GET/api/v1/alertsList alert rules
GET/api/v1/alerts/eventsList alert events timeline
Open dashboardBackend OpenAPI (dev)