Prism API Reference
Welcome to the Prism API. The Prism API provides programmatic access to our Consumer Intelligence engine, allowing you to ingest raw feedback, trigger analyses, and retrieve executive-ready insights.
Authentication
The Prism API uses API keys to authenticate requests. You can view and manage your API keys in the Prism Dashboard under Workspace Settings > API Keys. Provide your API key as the bearer token value in the Authorization header.
Authorization: Bearer prism_live_xxxxxxxxxxxxxxxxx1. Ingest Feedback
Upload raw customer feedback (reviews, survey responses, support tickets) to a specific project.
/projects/{project_id}/feedbackcurl -X POST https://api.prismintel.co/v1/projects/prj_123/feedback \
-H "Authorization: Bearer prism_live_abc123" \
-H "Content-Type: application/json" \
-d '{"source": "typeform", "data": [{"text": "The app is great but it crashes on checkout.", "user_id": "usr_9982", "timestamp": "2026-06-28T14:32:00Z"}]}'
2. Ingest Behavioral Telemetry
Send behavioral events to correlate what users do with what they say. This powers the Say vs. Do Gaps engine. The user_id must match the ID used in feedback ingestion.
/telemetry/eventscurl -X POST https://api.prismintel.co/v1/telemetry/events \
-H "Authorization: Bearer prism_live_abc123" \
-H "Content-Type: application/json" \
-d '{"user_id": "usr_9982", "event_name": "checkout_abandoned", "properties": {"cart_value": 149.99, "device": "iOS"}}'
3. Trigger Analysis
Trigger an asynchronous analysis run on the ingested feedback. Returns an analysis_id to query later, or optionally pushes to your webhook_url.
/projects/{project_id}/analyzeWebhooks
Prism can push events to your servers when certain actions occur, such as when an automated scheduled analysis completes. Configure webhooks in your Dashboard.
analysis.completedanalysis.faileddata.ingestion_limit_reached