Spekit provides a robust collection of API endpoints designed to help you access, analyze, and visualize key data points from your organization. Whether you are building custom BI dashboards or syncing user data, our API provides the transparency needed to measure enablement ROI.
📌 Quick-Jump Topics
- 1. Spekit API Capabilities
- 2. Advanced User Activity Tracking
- 3. Technical Guardrails & Rate Limits
- 4. How to generate an API token
1. Spekit API Capabilities
Spekit APIs currently support the GET method, allowing you to securely retrieve data across these four core pillars:
👤 User Intelligence
Retrieve details about your organization's users, including account creation date, team membership, and roles.
🔍 Search Insights
Access user search history, including keywords and timestamps.
📈 Content Views
View user reactions to specific Speks, including reaction types and associated metadata.
🎭 Feedback & Reactions
Track user interactions with Speks, such as views, sources, and timestamps.
2. Advanced User Activity Tracking
Retrieve a list of users who have performed specific activities on the Spekit platform. Supported activity types include:
| Activity Category | Retrievable Data Points |
|---|---|
| Topic Creation | Details on newly created topics. |
| Search Activity | Information on user search queries. |
| Team Creation | Data on newly created teams. |
| File Uploads & Asset Interactions | Track uploaded files and marked assets. |
| Spek Activity | Includes Spek creation, views, reactions, and read confirmations. |
| Flows & Spotlights | Insights into flow starts, completions, and new Spotlights. |
| Knowledge Checks | Track knowledge check attempts and completions. |
| AI Recommendations | View AI-driven content recommendations and interactions. |
3. Technical Guardrails & Rate Limits
To ensure platform stability and high performance for all users, Spekit enforces the following API limits:
⚠️ Rate Limit: 30 Requests / 10 Seconds
Our system allows for short bursts of activity, but sustained requests exceeding this threshold will result in HTTP 429 (Too Many Requests) errors. Integration developers should implement exponential backoff logic to handle these limits gracefully.
4. How to generate an API token
To use the API, you need an API token for authentication. Only Spekit Account Admins can generate tokens.
- Open the Spekit Web App.
- Navigate to Settings → API Tokens.
- Configure Token: Enter a clear description (e.g., "Tableau Reporting Sync") and set a custom expiration period (ranging from 1 week to "Never Expire").
- Click Generate new token.
- Secure Your Token: Copy the token immediately and save it in a secure location.
⚠️ WARNING: For security, the token is only displayed once and cannot be retrieved later.
Need Technical Assistance? Please reach out to our Support Team at support@spekit.co or refer to the API Documentation.