transcript.imDocs
DocumentationAPI Reference

List library transcripts

GET
/v1/library/transcripts

List the saved content owned by the authenticated account: single transcripts and batch records, with server-side search, platform/language filters, sort and pagination. Never returns another owner's rows or reads the shared cache.

AuthorizationBearer <token>

Session token (cookie-based auth in browser) or developer API key (tr_ prefix). API keys require the transcripts scope for /v1/transcript and the batches scope for /v1/batch.

In: header

Query Parameters

view?string
Default"all"

Value in

  • "all"
  • "starred"
  • "history"
q?string

Case-insensitive search over saved titles/channels.

Lengthlength <= 200
platform?string

Value in

  • "youtube"
  • "tiktok"
  • "instagram"
  • "upload"
  • "linkedin"
  • "twitter"
  • "batch"
lang?string
Lengthlength <= 20
sort?string
Default"recent"

Value in

  • "recent"
  • "oldest"
  • "title"
page?integer
Range1 <= value
Default1
pageSize?integer
Range1 <= value <= 100
Default24

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/library/transcripts"
{  "transcripts": [    {      "kind": "transcript",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "batchId": "5579c111-9c50-47e2-af92-f16d52e63189",      "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",      "jobStatus": "pending",      "platform": "youtube",      "externalId": "string",      "sourceUrl": "http://example.com",      "lang": "string",      "title": "string",      "channel": "string",      "thumbnailUrl": "string",      "source": "string",      "itemCount": 0,      "batchStatus": "string",      "failedCount": 0,      "errorCode": "string",      "words": 0,      "durationSec": 0,      "starred": true,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "page": 1,  "pageSize": 1,  "langs": [    "string"  ]}