---
title: "Get Segment Analytics"
method: GET
path: "/segments/{segmentId}/analytics"
tags: ["Analytics", "Segments"]
---

# Get Segment Analytics

`GET /segments/{segmentId}/analytics`

Get aggregated analytics for a specific segment including sentiment, safety metrics, topics, keywords, and an LLM-generated summary.

**Requires Growth+ plan or higher.**

Rate limited based on your plan's `maxAnalysesPerHour`. Cached results (less than 2 hours old) do not consume rate limit points.

## Path parameters

- `segmentId` string, uuid, required — The segment ID to get analytics for.

## Query parameters

- `productId` string, uuid — Filter analytics by product ID.
- `versionId` string, uuid — Filter analytics by version ID.

## Response `200`

Segment analytics retrieved successfully

- GetSegmentAnalyticsResponse
  - `averageUserSentiment` object, required — Average sentiment across all conversations.
    - `label` string, required
    - `score` number, required
  - `averageChangeInUserSentiment` object, required — Average change in user sentiment.
    - `label` string, required
    - `score` number, required
  - `averageFrustration` object, required — Average frustration level.
    - `score` number, required
    - `label` string, required
  - `averageStruggle` object, required — Average struggle level.
    - `score` number, required
    - `label` string, required
  - `averageCommercialIntent` object, required — Average commercial intent.
    - `score` number, required
    - `label` string, required
  - `averageConversationQualityIndex` number, nullable — Average conversation quality index.
  - `averageConversationRating` number, nullable — Average conversation rating.
  - `topics` object[], required — Topics discussed across conversations.
    - `name` string, required
    - `count` number, required
  - `topicGroups` object[], required — Topic groups across conversations.
    - `name` string, required
    - `count` number, required
  - `keywords` object[], required — Keywords extracted from conversations.
    - `name` string, required
    - `count` number, required
  - `summary` object, nullable, required — LLM-generated summary of the segment.
  - `hallucinationCount` object, required — Number of hallucinations detected.
    - `total` number, required
    - `percentage` number, required
  - `jailbreakCount` object, required — Number of jailbreak attempts detected.
    - `total` number, required
    - `percentage` number, required
  - `userBiasCount` object, required — Number of user bias detections.
    - `total` number, required
    - `percentage` number, required
  - `modelBiasCount` object, required — Number of model bias detections.
    - `total` number, required
    - `percentage` number, required
  - `userToxicityCount` object, required — Number of user toxicity detections.
    - `total` number, required
    - `percentage` number, required
  - `modelToxicityCount` object, required — Number of model toxicity detections.
    - `total` number, required
    - `percentage` number, required
  - `totalConversations` number, required — Total number of conversations in the segment.
  - `participantCount` number, required — Total number of participants in the segment.

## Other responses

- `403` — Requires paid plan
- `404` — Segment not found
- `429` — Rate limit exceeded
- `500` — Server error

## Changes

- **2026-05-01** `f52e699d4abf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/segments/:segmentId/analytics/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)
