Text Dialog Tags

Dialog tag classification is the task of classifying an utterance with respect to the function it serves in a dialogue, i.e. the act the speaker is performing

API Request

Returns the predicted dialog tag for a given sentence

POST https://api.marsview.ai/text/dialog_tag/get_dialog_tag

Query Parameters

Name	Type	Description
jwtToken*	String	Marsview api access token. You can generate it here: https://docs.marsview.ai/speech-analytics-api/authentication
sentence*	String	The sentence you want to predict dialog tag for
userId*	String	Your Email or User ID

200: OK Response with dialog tag prediction

{
    "status": true,
    "error": {},
    "data": {
        "dialogue_tag": "statement-opinion"
    }
    "userId": "[e-mail]",
}

400: Bad Request When a bad request is sent with missing key

{
    "status": false,
    "error": {
        "message": "Bad Request Missing key",
        "code": "RTSDTG002"
    },
    "data": {},
    "userId": "[e-mail]"
}

401: Unauthorized When the user requested with an invalid jwt token

{
    "status": false,
    "message": "Something went wrong while validating your JWT token."
}

Example Curl Request

Shown below is a code snippet to send a sample request for dialog tag detection

curl --location --request POST 'https://api.marsview.ai/text/dialog_tag/get_dialog_tag' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jwtToken": "Insert JWT token Key",
    "sentence": "Insert your sentence for dialog tag prediction here",
    "userId"  : "[e-mail]"
}'

Example Response

Shown below is a sample JSON response from the above request.

{
    "status" : true,
    "error"  : {},
    "data"   : {
        "dialogue_tag": "statement-opinion"
    }
    "userId": "[e-mail]",
}

Response Object

Field	Description
dialogTag	The tag label identified by the models for the given sentence