Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.useturret.com/llms.txt

Use this file to discover all available pages before exploring further.

Hero Light

​
Welcome to Turret

Turret is a product analytics API designed for AI/LLM applications. It helps you understand how users interact with your app through two core capabilities:
  • Semantic Topic Clustering: Automatically groups similar user messages/prompts by meaning using embeddings
  • User Journey Tracking: Tracks how users flow through different topics within conversations
Perfect for Product Managers who want to understand how people are prompting their LLMs and discover insights about user intent and behavior patterns.

​
Getting Started

Get up and running with Turret in minutes.

Quick Start

Start tracking events in under 5 minutes

Track Events

Learn how to track user events with metadata

​
Core Features

Discover what makes Turret different from traditional analytics.

Semantic Clustering

Automatically group similar events by meaning, not just exact matches

Journey Tracking

Track how users flow through topics within conversations

Segmentation

Filter topics by categorical metadata like platform, language, or user plan

API Reference

Simple, powerful API with just one endpoint

​
How It Works

  1. Event Ingestion: Send events with user prompts/messages to the /track endpoint
  2. Embedding Generation: Turret generates vector embeddings for your text using an embedding model
  3. Semantic Clustering: Events are grouped into clusters based on embedding similarity
  4. Cluster Labeling: Clusters are automatically labeled with human-readable descriptions using an LLM
  5. Journey Tracking: When events share the same session_id, Turret tracks transitions between clusters

Dashboard

View your analytics, discover patterns, and explore user journeys in our web dashboard