Use the Conversation API to detect topics, which are the most important keywords or phrases in a conversation. bases the Topics model on a conversation structure with multiple interrelated concepts. This approach improves upon intuition and traditional topic modeling which depend on frequency, probability distribution, and supervised training algorithms.

In a free-flowing discussion, people tend to initiate a topic then switch to another topic as the conversation progresses. Every time a conversation changes context, the Topics algorithm detects the change and extracts the most relevant topics.

You can use the Topics algorithm as a framework to calibrate and precisely model relationships between topics. Derive the most relevant topics and develop a better understanding of context changes within a conversation.

The Topics algorithm improves on traditional keyword and linear discriminant analysis (LDA) driven models.

Highlights of the Topics model:

  • Keywords Ranking identifies the top keywords in a conversation. It also assigns a contextual score to keywords based on the graph intelligence that model’s the structure of the conversation.

  • Topic-based sentiments describes the ability to detect the segment of discussion in which the topic has an impact. You can see topic based sentiments in the Topics API response by passing sentiment=true as a query parameter.

  • Parent topics are the highest level of discussion abstraction. Parent topics can have one or more child topics per segment of a conversation. To see a conversation's Topic Hierarchy, pass the parentRefs=true parameter in the Get topics request.

  • The scope of a topic defines the sentences and the information in the conversation. The Topics model links scope to the topic of discussion. You can see the scope of the topic in the Topics API response.

  • Works with real-time and asynchronous conversations.


This request requires an access token, as described in Authenticate.

Get topics

This section describes how to get topics from a conversation. This request requires a conversation ID. You receive a conversation ID when you process a conversation with the APIs.

To get topics, use the request:


To make this request from the API reference, see Get topics.

Topic Hierarchy

Topic Hierarchy is the one-to-many relationship of a Parent Topic to Child Topics.

Parent Topics are the highest-level abstraction of a meeting. These are the key points that the speakers discussed at length.

Child Topics are the subtopics that aggregate or are originated from the Parent Topic.

In any conversation, there can be multiple related topics discussed. It is possible to organize them in a hierarchy for better insights and consumption. The Topic Hierarchy algorithm finds patterns in the conversation and creates parent (global) topics. Each parent topic can have any number of nested child topics.

Consider a meeting that includes discussions about: “Sales Conversation” and then “Activity Call Logs”, “Salesforce”, “Draft”, “Custom Integration” and “Jira”. The Topics Hierarchy makes Sales Conversation the parent topic and the rest of the topics are the child topics under it.

Abstract Topics (Labs)

Abstract topics show recurrent themes in a conversation. You can quickly scan the list of recurring topics to see what was covered.

For example:

  • Conversation on topics such as pricing, negotiation, sales representative, and so on, are abstracted to Sales.

  • Conversation about coughing, cold, fever, chills, chest pain, are abstracted to Covid-19 Symptoms.

Abstract Topics API request

To get abstract topics, you must first process your conversation using the Async API. After you process the conversation, you receive a Conversation ID which you must pass in Get abstract topics.

To get abstract topics, use the request:


To make this request from the API reference, see Get abstract topics.