transcript.imDocs
DocumentationAPI Reference
DocumentationAPI Reference

Download transcript

GET
/v1/library/transcripts/{platform}/{externalId}/download

Export a transcript saved in the owner's library as txt, srt, vtt, json, or md. Requires a paid plan (same gate as batch export). Omit language for the owner's latest saved language. Unowned content returns 404.

Authorization

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

Path Parameters

platform*string

Value in

  • "youtube"
  • "tiktok"
  • "instagram"
  • "upload"
  • "linkedin"
  • "twitter"
externalId*string

Query Parameters

format?string
Default"txt"

Value in

  • "txt"
  • "srt"
  • "vtt"
  • "json"
  • "md"
language?string

Exact language tag; omitted returns the latest result.

Response Body

text/plain

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/library/transcripts/youtube/string/download"
"string"

List library transcripts GET

List the saved content owned by the authenticated account: single transcripts and batch records, with server-side search, platform/language filters, sort and pagination.

List related transcripts GET

Related same-channel transcripts saved in the owner's library.