API
Read your sessions, transcripts and analytics from your own systems. Available on the Enterprise plan.
The API is read-only. It lets your own systems fetch what Every Voice has recorded for your organization.
Getting a key
Go to Settings, API access, name your key and press Create key. Copy it right away, because it won't be shown again. If a key is exposed, revoke it there.
Making requests
Send your key as a bearer token. The limit is 600 requests a minute.
curl https://everyvoice.live/api/v1/live \
-H "Authorization: Bearer etk_your_key"
Endpoints
| Request | Returns |
|---|---|
GET /api/v1/live | The current session and listener counts |
GET /api/v1/sessions?limit=50&q=word | Your sessions. q searches titles and transcripts. |
GET /api/v1/sessions/{id} | One session |
GET /api/v1/sessions/{id}/transcript?lang=orig | The transcript. Use orig or a language code such as es. |
GET /api/v1/sessions/{id}/analytics | Audience and quality numbers for one session |
GET /api/v1/analytics/overview?days=30 | Totals across your sessions, for 1 to 365 days |
Responses are JSON.
Errors
| Status | Meaning |
|---|---|
| 401 | The key is missing or isn't valid |
| 403 | Your plan doesn't include the API |
| 404 | That session doesn't exist in your organization |
| 429 | You've gone over 600 requests a minute |