Skip to main content

​
Get Your API Key

Before you can start tracking events, you’ll need to get your API key from the Turret dashboard.

​
Create an Account

Visit the Turret Dashboard and create your account. You’ll get a free tier to start experimenting with event tracking.
Once logged in, you’ll find your API key in the Dashboard. This key will be used to authenticate your requests to the Turret API.
Keep your API key secure and never expose it in client-side code. Use it only in your backend services.

​
Track Your First Event

Use the /track endpoint to send your first event. Here’s a simple example:
curl -X POST https://api.useturret.com/track \
  -H "X-Api-Key: your_project_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "User asked question",
    "metadata": {
      "prompt": "How do I reset my password?"
    }
  }'
The name field describes what happened, and the metadata object contains the free-form text that Turret will analyze.
After sending a few events, visit your dashboard to see how Turret has automatically clustered your events based on semantic similarity.

​
Integration Examples

Here are some common ways to integrate Turret into your application:

JavaScript/Node.js

Track events from your JavaScript application

Python

Integrate with your Python backend

cURL

Simple HTTP requests for any language

Best Practices

Learn how to structure your events for maximum insight

​
Next Steps

Now that you’ve tracked your first event, explore these topics:
  1. Understanding Topics - Learn how Turret groups your events
  2. Tracking Events - Detailed guide on event tracking
  3. Best Practices - Get the most value from your data
  4. API Reference - Complete API documentation