Insights

This API provides you with useful conversational insights that can measure or help measure many of your KPIs.

Overview
Perform in-depth analysis of conversational data to visualize trends on topics, sentiments, keywords, and behaviors to achieve better outcomes.
Marsview provides a way to capture the engagement level of speakers in real-time. Additionally, you can track user sentiment and emotions along with engagement data.
Insights 
For each conversation/file uploaded it returns the following
Insight
Description
Talk-to-listen Ratio
Speaker’s talk and listen ratio and time
Speech Insights 
Insights based on speakers such as- Longest monologue, filler words used, speech clarity, etc. 
Call Sentiment Score
Gives an overall assessment of the conversation sentiment based on the sentiments, emotions, and tone used in the conversation
Call Engagement Score
Gives an overall assessment of the conversation engagement based on the talk-time, dead air, and other factors.
Call Score
Scores the call based on different quantitative and qualitative measurements of the conversation. This can be further customized to the business need.
Avg. Speech Speed
Get speech speed by the speaker in terms of WPM (words per minute)
Sentiment vs Time
Capture variations in sentiment over the course of the call by each speaker individually and combined.
Phrase Cloud (by Topics Type)
Captures salient topics found or spoken in the conversation.
Topic Sentiment over Time
Capture variations in sentiment over the course of the call by each speaker individually and combined along with the corresponding topics mentioned.
Speaker Emotions over Time
Capture variations in emotions over the course of the call by each speaker individually and combined.
Dead Air
timestamps of dead air (silence) found during the conversation 
post
Insights
https://api.marsview.ai/v1/conversation/insights
This method is used to upload an audio or video file on which metadata has to be computed.
Settings object can be used to enable/disable metadata from different models. Check the overview section for getting a list of models that are available
Request
Response
Request
Headers
appSecret
required
string
<sample-app-secret>
appId
required
string
<sample-app-Id>
Content-Type
optional
string
application/json
Body Parameters
topics.global_enable
optional
boolean
Global topics extracted from the entire audio/video file will appear as a separate object.
Response
200: OK
Each insights section has its own object  
{
    "status":true,
    "transaction_id":32dcef1a-5724-4df8-a4a5-fb43c047716b,
    "insights":{
      "talk_to_listen":{
          ...
      },
      "speech_insights":{
          ...
      },
      "call_sentiment":{
          ...
      },
      "call_engagement":{
          ...
      },
      "call_score":{
          ...
      }
    }
}
Example API Call
Request
CURL
CURL
curl --request POST 'https://api.marsview.ai/v1/conversation/insights' \
--header 'appSecret: 32dcef1a-5724-4df8-a4a5-fb43c047716b' \
--header 'appId: 1ZrKT0tTv7rVWX-qNAKLc' \
--header 'Content-Type: application/json' \
--data-raw '{
                "settings":{
                     "insights":{
                          "talk_to_listen":true,
                          "speech_insights":true,
                          "call_sentiment":true,
                          "call_engagement":true,
                          "call_score":true
                     }  
                 }
          }'
Response
Given below is a sample response JSON when the Status code is 200.
{
    "status":true,
    "transaction_id":32dcef1a-5724-4df8-a4a5-fb43c047716b,
    "insights":{
      "talk_to_listen":{
          ...
      },
      "speech_insights":{
          ...
      },
      "call_sentiment":{
          ...
      },
      "call_engagement":{
          ...
      },
      "call_score":{
         ...
      }
    }
}

Conversation API (Bundle) - Previous

Abstractive Summary

Next - Conversation API (Bundle)

Screengrabs (Visual)

Last updated 3 months ago

Insight	Description
Talk-to-listen Ratio	Speaker’s talk and listen ratio and time
Speech Insights	Insights based on speakers such as- Longest monologue, filler words used, speech clarity, etc.
Call Sentiment Score	Gives an overall assessment of the conversation sentiment based on the sentiments, emotions, and tone used in the conversation
Call Engagement Score	Gives an overall assessment of the conversation engagement based on the talk-time, dead air, and other factors.
Call Score	Scores the call based on different quantitative and qualitative measurements of the conversation. This can be further customized to the business need.
Avg. Speech Speed	Get speech speed by the speaker in terms of WPM (words per minute)
Sentiment vs Time	Capture variations in sentiment over the course of the call by each speaker individually and combined.
Phrase Cloud (by Topics Type)	Captures salient topics found or spoken in the conversation.
Topic Sentiment over Time	Capture variations in sentiment over the course of the call by each speaker individually and combined along with the corresponding topics mentioned.
Speaker Emotions over Time	Capture variations in emotions over the course of the call by each speaker individually and combined.
Dead Air	timestamps of dead air (silence) found during the conversation

Insights

Overview

Insights

postInsights

Example API Call

Request

Response

post
Insights