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"
        ]
     

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)

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).

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.

Speaker Balance Score

Speaker Key Points

Last modified 5mo ago