Skip to main content

Receive Speech-to-Text and AI Insights

Process video file#

The first thing you need to do before getting your speech-to-text and AI insights you need to process your video file. This code is taken directlyh from our POST Video URL page. If you want to use an audio or text file you can use the code from the POST Audio URL or POST Text File pages.

While we provide you with a default video URL, you can replace that with any other video URL.

Request Example#

curl --location --request POST "" \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $AUTH_TOKEN" \
--data-raw '{
"url": "",
"name": "BusinessMeeting"

Response Example#

"conversationId": "5815170693595136",
"jobId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

Receive Speech-to-Text#

In the response above, you will notice the conversationId field. Using the conversationId you can send a request to GET Speech to Text endpoint in the Conversation API.

Request Example#

curl "$CONVERSATION_ID/messages" \
-H "Authorization: Bearer $AUTH_TOKEN"

Response Example#

"messages": [{
"id": "6412283618000896",
"text": "Best package for you is $69.99 per month.",
"from": {
"name": "Roger",
"email": ""
"startTime": "2020-07-10T11:16:21.024Z",
"endTime": "2020-07-10T11:16:26.724Z",
"conversationId": "6749556955938816",
"phrases": [{
"type": "action_phrase",
"text": "$69.99 per month"

Receiving More AI Insights#

Here's more data you can grab with our Conversation API:

View conversation topics
Summary topics provide a quick overview of the key things that were talked about in the conversation.

View action items
An action item is a specific outcome recognized in the conversation that requires one or more people in the conversation to take a specific action, e.g. set up a meeting, share a file, complete a task, etc.

View follow-ups
This is a category of action items with a connotation to follow-up a request or a task like sending an email or making a phone call or booking an appointment or setting up a meeting.