> ## 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.

# Introduction

> Understand how users interact with your AI app through semantic clustering and journey tracking

<img className="block dark:hidden" src="https://mintcdn.com/turret/oQTh1hK_YokBMnvg/images/hero.png?fit=max&auto=format&n=oQTh1hK_YokBMnvg&q=85&s=9c0e351384d93442cbd9a5966cadf717" alt="Hero Light" width="1512" height="982" data-path="images/hero.png" />

<img className="hidden dark:block" src="https://mintcdn.com/turret/oQTh1hK_YokBMnvg/images/hero.png?fit=max&auto=format&n=oQTh1hK_YokBMnvg&q=85&s=9c0e351384d93442cbd9a5966cadf717" alt="Hero Dark" width="1512" height="982" data-path="images/hero.png" />

## 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.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Start tracking events in under 5 minutes
  </Card>

  <Card title="Track Events" icon="chart-line" href="/essentials/tracking-events">
    Learn how to track user events with metadata
  </Card>
</CardGroup>

## Core Features

Discover what makes Turret different from traditional analytics.

<CardGroup cols={2}>
  <Card title="Semantic Clustering" icon="brain" href="/essentials/understanding-topics">
    Automatically group similar events by meaning, not just exact matches
  </Card>

  <Card title="Journey Tracking" icon="route" href="/essentials/understanding-topics#journey-tracking">
    Track how users flow through topics within conversations
  </Card>

  <Card title="Segmentation" icon="filter" href="/essentials/segmentation">
    Filter topics by categorical metadata like platform, language, or user plan
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Simple, powerful API with just one endpoint
  </Card>
</CardGroup>

## 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

<Card title="Dashboard" icon="chart-pie" href="https://dashboard.useturret.com">
  View your analytics, discover patterns, and explore user journeys in our web dashboard
</Card>