> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Conversatieonderwerpen van agent ophalen

GET https://api.elevenlabs.io/v1/convai/agents/{agent_id}/topics

Retourneert de resultaten van de meest recente topic discovery-uitvoering voor een opgegeven agent.

Reference: https://elevenlabs.io/docs/api-reference/conversations/topics/get

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `agent_id` (string, required) — ID van de agent

### Query parameters

- `page_size` (integer, optional, nullable) — Aantal topicgroepen op het hoogste niveau dat moet worden geretourneerd.
- `sort_by` (enum, optional) — Kolom waarop onderwerpen moeten worden gerangschikt. Gebruik conversations voor volume, sentiment met sort_direction=asc voor de negatiefste onderwerpen, en frustration met sort_direction=desc voor de meest frustrerende onderwerpen. Onderwerpen zonder score worden altijd als laatste gerangschikt.
  - Allowed values: `conversations`, `sentiment`, `success_rate`, `frustration`
- `sort_direction` (enum, optional) — Sorteerrichting voor onderwerpen.
  - Allowed values: `asc`, `desc`
- `from_unix_secs` (integer, optional, nullable) — Begin van het tijdvenster waarvoor onderwerpen worden weergegeven. Wanneer dit samen met to_unix_secs is ingesteld, worden de voltooide dagelijkse uitvoeringen voor onderwerpdetectie in het bereik samengevoegd. Het venster begrenst dus zowel de statistieken als de onderwerpset. Afgerond naar het begin van de UTC-dag, omdat uitvoeringen volledige UTC-dagen omvatten; aggregated_run_count geeft aan hoeveel uitvoeringen zijn opgeteld. Laat beide grenzen weg om alleen de meest recente uitvoering op te halen.
- `to_unix_secs` (integer, optional, nullable) — Einde van het tijdvenster waarvoor onderwerpen worden weergegeven.
- `include_evaluation_criteria` (boolean, optional, default: true) — Neem de uitsplitsing van de evaluatie per criterium op in de statistieken van elk onderwerp. Geef false door om deze weg te laten: deze vormt het grootste deel van de payload en de gewogen success_rate wordt in beide gevallen geretourneerd.
- `cursor` (string, optional, nullable) — Gebruikt om de volgende pagina op te halen. De cursor wordt teruggegeven in de response.

## Response

### 200

Geslaagde response

- `topics` (list of AgentTopicResponseModel, required)
- `window_start_unix_secs` (integer, required)
- `window_end_unix_secs` (integer, required)
- `aggregated_run_count` (integer, optional, default: 0) — Aantal dagelijkse topic-discovery-runs waarover de geretourneerde statistieken zijn opgeteld.
- `has_more` (boolean, optional, default: false)
- `next_cursor` (string, optional, nullable)

## Errors

### 422 Unprocessable Entity Error

Validatiefout

- `detail` (list of ValidationError, optional)

## Types

### AgentTopicResponseModel

- `topic_id` (string, required)
- `label` (string, required)
- `description` (string, required)
- `conversation_count` (integer, required)
- `parent_topic_id` (string, optional, nullable)
- `x_2d` (double, optional, nullable)
- `y_2d` (double, optional, nullable)
- `metrics` (TopicMetricsAggregate, optional, nullable)
- `success_rate` (double, optional, nullable) — Succespercentage voor de evaluatiecriteria van het onderwerp, gewogen op basis van beoordeelde gesprekken. Wordt geretourneerd ongeacht include_evaluation_criteria.

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### TopicMetricsAggregate

- `conversation_count` (integer, optional, default: 0)
- `sentiment` (TopicSentimentAggregate, optional, nullable)
- `evaluation_criteria` (list of TopicEvaluationCriteriaAggregate, optional)

### ValidationErrorLocItems

### TopicSentimentAggregate

- `sentiment` (NumericDistributionAggregate, optional)
- `frustration` (NumericDistributionAggregate, optional)
- `positive_count` (integer, optional, default: 0)
- `neutral_count` (integer, optional, default: 0)
- `negative_count` (integer, optional, default: 0)

### TopicEvaluationCriteriaAggregate

- `criteria_id` (string, required)
- `success_count` (integer, optional, default: 0)
- `failure_count` (integer, optional, default: 0)
- `unknown_count` (integer, optional, default: 0)

### NumericDistributionAggregate

- `count` (integer, optional, default: 0)
- `sum` (double, optional, default: 0)
- `min` (double, optional, nullable)
- `max` (double, optional, nullable)

## Examples

**Response**

```json
{
  "topics": [
    {
      "topic_id": "string",
      "label": "string",
      "description": "string",
      "conversation_count": 1,
      "parent_topic_id": "string",
      "x_2d": 1.1,
      "y_2d": 1.1,
      "metrics": {
        "conversation_count": 0,
        "sentiment": {
          "sentiment": {
            "count": 0,
            "sum": 0,
            "min": 1.1,
            "max": 1.1
          },
          "frustration": {
            "count": 0,
            "sum": 0,
            "min": 1.1,
            "max": 1.1
          },
          "positive_count": 0,
          "neutral_count": 0,
          "negative_count": 0
        },
        "evaluation_criteria": [
          {
            "criteria_id": "string",
            "success_count": 0,
            "failure_count": 0,
            "unknown_count": 0
          }
        ]
      },
      "success_rate": 1.1
    }
  ],
  "window_start_unix_secs": 1,
  "window_end_unix_secs": 1,
  "aggregated_run_count": 0,
  "has_more": false,
  "next_cursor": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/agents/agent_id/topics"

response = requests.get(url)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/agents/agent_id/topics';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/agents/agent_id/topics"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/agents/agent_id/topics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.elevenlabs.io/v1/convai/agents/agent_id/topics")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/agents/agent_id/topics');

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/agents/agent_id/topics");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/agents/agent_id/topics")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```