Search transcripts

Search the transcripts in a workspace and return matching snippets with their recording, timestamps and speakers. Defaults to semantic search (find by meaning); pass mode=exact for literal keyword matching. Optionally narrow by folder, speaker, or recording date.

GET /api/v1/spaces/{spaceId}/recordings/search

API key in header x-api-key

curl 'https://transcript.lol/api/v1/spaces/space_01JXY9AZK4KV/recordings/search?q=example&mode=semantic&folderIds=folder_01JXY9AZK4KV&speakerIds=speaker_01JXY9AZK4KV&dateFrom=2026-01-01T12%3A00%3A00Z&dateTo=2026-01-01T12%3A00%3A00Z' \
  --request GET \
  --header 'x-api-key: YOUR_API_KEY'

[
  {
    "documentId": "document_01JXY9AZK4KV",
    "text": "example",
    "start": 1,
    "end": 1,
    "speakers": [
      "example"
    ],
    "score": 1,
    "transcriptId": "transcript_01JXY9AZK4KV",
    "recording": {
      "id": "id_01JXY9AZK4KV",
      "createdAt": "2026-01-01T12:00:00Z",
      "updatedAt": "2026-01-01T12:00:00Z",
      "workspaceId": "workspace_01JXY9AZK4KV",
      "title": "example",
      "sourceUrl": "https://example.com/source",
      "mediaType": "AUDIO",
      "source": "example",
      "duration": 1,
      "status": "MEDIA_IMPORT_UPLOADING",
      "recordingFolderId": "recording_folder_01JXY9AZK4KV",
      "isMediaDeleted": true,
      "createdById": "created_by_01JXY9AZK4KV",
      "autoDeleteMediaAfter": "example"
    }
  }
]

Matching transcript snippets

Path parameters

· 1

spaceId string required

ID of the workspace.

Query parameters

· 6

q string required

What to look for in the transcripts.

mode string · enum

"semantic" (default) finds results by meaning; "exact" matches the literal keywords.

values

semantic
exact

folderIds array of string

Restrict to these folder IDs. Repeat the param or comma-separate.

speakerIds array of string

Restrict to chunks where these speakers talk. Repeat the param or comma-separate.

dateFrom string · date-time

Only recordings created on/after this ISO 8601 date.

dateTo string · date-time

Only recordings created on/before this ISO 8601 date.

Path parameters

Query parameters

Responses