# Conversation Topics and Keywords

The Meetra AI API provides endpoints for retrieving information about topics discussed in a processed meeting recording. 

**Endpoint:** 

`/single-feature-api/meeting/topics`

**HTTP Method:** GET

#### Parameters

| Parameter        | Type    | Description                                               |
| ---------------- | ------- | --------------------------------------------------------- |
| `Authorization`  | string  | Bearer token for authentication.                          |
| `file-hash`      | string  | Hash of the meeting recording file.                       |
| `period_seconds` | integer | Length of the period in seconds (optional, default: 300). |

#### Request

```http
GET /single-feature-api/meeting/topics?file-hash=<file-hash>&period_seconds=<period_seconds>
Authorization: Bearer <JWT_token>
```

#### Responses

| HTTP Status Code | Description                                     | Schema        |
| ---------------- | ----------------------------------------------- | ------------- |
| 200              | Successful retrieval of topics for the meeting. | TopicsModel   |
| 400              | Bad request.                                    | ErrorResponse |
| 401              | Unauthorized.                                   | ErrorResponse |
| 404              | Meeting not found.                              | ErrorResponse |
| 500              | Internal server error.                          | ErrorResponse |

**TopicsModel (schema)**

| Property | Type  | Description                              |
| -------- | ----- | ---------------------------------------- |
| `topics` | array | List of topics discussed in the meeting. |

**TopicDetails (object)**

| Property | Type    | Description                                      |
| -------- | ------- | ------------------------------------------------ |
| `topic`  | string  | Name of the topic.                               |
| `start`  | integer | Start time of the topic segment in milliseconds. |
| `end`    | integer | End time of the topic segment in milliseconds.   |

**Example Response**

```json
{
  "topics": [
    {
      "end": 300000,
      "start": 0,
      "topic": "topic name"
    }
  ]
}
```