Meetra AI
Search
K
Comment on page

Topic Dynamics & Details

API endpoint to retrieve the list of dynamics around discovered topic including energy, sentiment and speakers

Endpoint

GET /single-feature-api/meeting/details-by-topics

Parameters

Name
Type
Description
Authorization
Header
Bearer token for authentication.
file-hash
Query
Hash of the meeting recording file.
period_seconds
Query
Length of the period in seconds (default: 300)

Request Headers

The request should include the following header:
Authorization: Bearer <token>

Request Query Parameters

The request may include the following query parameters:
Name
Type
Required
Description
file-hash
string
true
Hash of the meeting recording file.
period_seconds
integer
false
Length of the period in seconds (default: 300).

Responses

HTTP Code
Description
200
Success. Returns the list of details about topics in the meeting as JSON.
400
Bad request. Invalid or missing parameters.
401
Unauthorized. Invalid or expired token.
404
Meeting not found.

Success Response

HTTP Code: 200
Response Body:
{
"topics": [
{
"topic": "topic name",
"start": 0,
"end": 300000,
"speakers": [
{
"id": "1c2ee2da-e2f6-433d-b554-248707c2491c",
"alias": "Daniel"
},
...
],
"sentiment": "Somewhat Negative",
"emotions_score": 35,
"energy": {
"energy_score": 100,
"talking_time": 0.45,
"silence_time": 0.55,
"interactions": {
"nodes": [
{
"between": [
"8b3c1e7b-64da-4320-b699-0dc3cff03aae",
"1c2ee2da-e2f6-433d-b554-248707c2491c"
],
"value": 100
},
...
]
},
"emotions": [
"happiness"
]
},
"interactions_score": 40,
"involvement_score": 45
},
...
]
}

Error Responses

HTTP Code: 400
Response Body:
{
"message": "Bad request"
}
HTTP Code: 401
Response Body:
{
"message": "Unauthorized"
}
HTTP Code: 404
Response Body:
{
"message": "Meeting not found"
}

Example Response

HTTP Code: 200
Response Body:
{
"topics": [
{
"topic": "Space Invaders",
"start": 0,
"end": 300000,
"speakers": [
{
"id": "1c2ee2da-e2f6-433d-b554-248707c2491c",
"alias": "Derek"
},
{
"id": "8b3c1e7b-64da-4320-b699-0dc3cff03aae",
"alias": "Marie"
}
],
"sentiment": "Somewhat Negative",
"emotions_score": 35,
"energy": {
"energy_score": 100,
"talking_time": 0.45,
"silence_time": 0.55,
"interactions": {
"nodes": [
{
"between": [
"8b3c1e7b-64da-4320-b699-0dc3cff03aae",
"1c2ee2da-e2f6-433d-b554-248707c2491c"
],
"value": 100
},
{
"between": [
"8b3c1e7b-64da-4320-b699-0dc3cff03aae",
"d348a4ba-44ba-4fd3-a99a-81a7beca4ab4"
],
"value": 75
}
]
},
"emotions": [
"happiness"
]
},
"interactions_score": 40,
"involvement_score": 45
},
{
"topic": "another topic",
"start": 300000,
"end": 600000,
"speakers": [
{
"id": "1c2ee2da-e2f6-433d-b554-248707c2491c",
"alias": "D"
},
{
"id": "8b3c1e7b-64da-4320-b699-0dc3cff03aae",
"alias": "M"
},
{
"id": "d348a4ba-44ba-4fd3-a99a-81a7beca4ab4",
"alias": "T"
}
],
"sentiment": "Neutral",
"emotions_score": 50,
"energy": {
"energy_score": 75,
"talking_time": 0.6,
"silence_time": 0.4,
"interactions": {
"nodes": [
{
"between": [
"1c2ee2da-e2f6-433d-b554-248707c2491c",
"d348a4ba-44ba-4fd3-a99a-81a7beca4ab4"
],
"value": 90
},
{
"between": [
"d348a4ba-44ba-4fd3-a99a-81a7beca4ab4",
"8b3c1e7b-64da-4320-b699-0dc3cff03aae"
],
"value": 80
}
]
},
"emotions": [
"neutral",
"happiness"
]