API
Build checks into your workflow.
Every Prism feature is available via API. Build pre-deploy checks into your CI/CD, wire checks into your agency pipeline, gate Webflow publishes on results. Streaming reactions, full report payload, webhooks, Node + Python SDKs.
Quickstart
One curl, three reactions, sixty seconds.
curl -X POST https://api.prism.ai/v1/checks \
-H "Authorization: Bearer $PRISM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "landing-page",
"url": "https://your-site.com",
"audience": "saas-b2b-smb",
"stream": true
}'Endpoints
Seven verbs. That's the whole API.
| Method | Path | Description |
|---|---|---|
| POST | /v1/checks | Run a check. Returns a check_id and streams reactions via SSE. |
| GET | /v1/checks/:id | Get a check report (poll if not streaming). |
| GET | /v1/checks/:id/stream | Server-sent events stream of reactions as they complete. |
| GET | /v1/audiences | List available pre-built audiences with status, accuracy, last audit. |
| POST | /v1/audiences | Create a custom audience from a one-line brief. Returns cluster_id once calibrated. |
| GET | /v1/clusters/:id/validation | Cluster's accuracy, ground-truth source, sample size, last audit date. |
| POST | /v1/webhooks | Register a webhook URL. Receives check.completed, check.failed, audience.calibrated events. |
Rate limits
Honest. By tier.
| Tier | Requests / minute | Checks included |
|---|---|---|
| Free | 10 req/min | 3 / month |
| Founder (€39/mo) | 60 req/min | Unlimited |
| Team (€99/mo) | 300 req/min | Unlimited · 10k API calls/mo |
| Agency (€499/mo) | 1,000 req/min | Unlimited · 100k API calls/mo |
SDKs
Node, Python, Bash. More on request.
npm i @prism-ai/sdk · pip install prism-ai. Both are thin wrappers around the REST API with full TypeScript types and streaming helpers. Source on GitHub. Open issues if a method's missing.
Get an API key.
Founder tier and above. Generate from your dashboard, scope it per workspace, rotate anytime.