Snapshot API
Access to pre-generated analytics data.
The Snapshot API provides access to pre-generated analytics data, including LiveChat conversations. Data is generated automatically, and the API enables retrieval of this data for external analysis.
Snapshot API
All datasets use the same endpoints to retrieve data.
Common endpoints
GET
/api/v1/datasets/{dataset}/availability
Retrieves a list of dates for which data is available.
GET
/api/v1/datasets/{dataset}/snapshots/{date}
Retrieves data for a given date. Note: This endpoint does not generate data.
Dataset articles
LiveChat analytics
Analytics, error logs, and session data for LiveChat conversations.
API key management
API keys allow external applications to access Easybook data. Each key belongs to one company.
Authentication
Add the API key to the x-api-key header.
curl -H "x-api-key: eb_your_api_key_here" \ "https://api.easybook.fi/api/v1/datasets/livechat-analytics/snapshots/2026-03-25"
Key format
Keys start with the prefix eb_ and are 52 characters long.
eb_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
Management endpoints
| GET | /api/api-keys | – List all keys |
| POST | /api/api-keys | – Create a new key |
| POST | /api/api-keys/:keyId/rotate | – Rotate key to a new one |
| PATCH | /api/api-keys/:keyId/revoke | – Revoke key immediately |
| DELETE | /api/api-keys/:keyId | – Delete key permanently |
Limits
| Setting | Value | Description |
|---|---|---|
| Maximum active keys | 10 | Per company |
| Default expiration | 90 | Days when not specified |
| TRANSITION PERIOD | 7 | Days upon key rotation |
| Expiration options | 30, 60, 90, 365 | Days |