TranscriptAPI

{"openapi":"3.0.3","info":{"title":"transcript1 API","version":"1.0.0"},"servers":[{"url":"https://api.transcript1.com/v1"}],"tags":[{"name":"Transcriptions","description":"Create, read, list and delete transcriptions of video links and uploaded files."},{"name":"Uploads","description":"Send a large file in chunks. Start with Create a transcription using an `upload` body. Send each chunk, then complete the upload."},{"name":"Account","description":"Your plan, remaining minutes and rate limits."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"transcript1 API key (`t1_...`) or OAuth access token (`t1o_...`)."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"invalid_request"},"message":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"additionalProperties":{"nullable":true}}},"required":["error"]},"InsufficientMinutesError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["insufficient_minutes"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"action_url":{"type":"string","description":"Where to top up","example":"https://transcript1.com/dashboard/billing"},"minutes_needed":{"type":"integer","nullable":true,"description":"Minutes needed for this transcription. Available when the media duration is known."},"minutes_remaining":{"type":"integer","description":"Usable minutes left on the account"}},"required":["code","message","retryable","action_url","minutes_needed","minutes_remaining"]}},"required":["error"]},"Account":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"user":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"}},"required":["id","email"]},"plan":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"minutes":{"type":"object","properties":{"remaining":{"type":"number"},"cycle":{"type":"number"},"topup":{"type":"number"},"topup_usable":{"type":"boolean"},"resets_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["remaining","cycle","topup","topup_usable","resets_at"]},"renews_at":{"type":"string","nullable":true,"format":"date-time"},"limits":{"type":"object","properties":{"requests_per_minute":{"type":"number"},"max_active_jobs":{"type":"number"}},"required":["requests_per_minute","max_active_jobs"]}},"required":["object","user","plan","minutes","renews_at","limits"],"example":{"object":"account","user":{"id":"5b0e6c1c-0d6f-4c1f-9b5e-8f3f4d0a7a11","email":"you@example.com"},"plan":{"id":"9d4e0c0a-2b8a-4f0c-8d63-6a8d3c8a1f22","name":"Monthly"},"minutes":{"remaining":1180,"cycle":980,"topup":200,"topup_usable":true,"resets_at":"2026-11-13T09:30:00.000Z"},"renews_at":"2026-11-13T09:30:00.000Z","limits":{"requests_per_minute":200,"max_active_jobs":10}}},"Transcription":{"type":"object","properties":{"id":{"type":"string","example":"tr_4fHq8ZbN2xLm0PqRsTuVwX"},"object":{"type":"string","enum":["transcription"]},"status":{"type":"string","enum":["awaiting_upload","queued","fetching","transcribing","completed","failed","canceled"]},"source":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string"},"url":{"type":"string","nullable":true},"media_id":{"type":"string","nullable":true}},"required":["platform","url","media_id"]},{"type":"object","properties":{"platform":{"type":"string","enum":["upload"]},"filename":{"type":"string","nullable":true},"size":{"type":"number","nullable":true}},"required":["platform","filename","size"]}]},"media":{"type":"object","nullable":true,"properties":{"title":{"type":"string","nullable":true},"author":{"type":"string","nullable":true},"author_url":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"filename":{"type":"string"},"mime_type":{"type":"string"},"size":{"type":"number"},"duration_seconds":{"type":"number","nullable":true}}},"options":{"type":"object","properties":{"source":{"type":"string","enum":["auto","captions","stt"]},"language":{"type":"string","example":"auto"},"diarize":{"type":"boolean"}},"required":["source","language","diarize"]},"transcript_source":{"type":"string","nullable":true,"enum":["youtube_captions","x_captions","tiktok_captions","bluesky_captions","dailymotion_captions","linkedin_captions","speech_to_text"]},"caption_kind":{"type":"string","nullable":true,"enum":["manual","auto_generated"],"description":"Null until resolved, for speech-to-text, or when native caption metadata does not establish authorship. Unknown does not mean manual."},"language":{"type":"string","nullable":true},"billed_minutes":{"type":"integer","nullable":true},"cached":{"type":"boolean"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string","nullable":true}},"required":["code","message"]},"created_at":{"type":"string","nullable":true,"format":"date-time"},"completed_at":{"type":"string","nullable":true,"format":"date-time"},"deleted_at":{"type":"string","nullable":true,"format":"date-time","description":"When the transcription was deleted. Always `null` unless the request includes `include_deleted=true`."},"transcript":{"type":"object","properties":{"text":{"type":"string"},"speakers":{"type":"array","items":{"type":"string"}},"segments":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"speaker":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"text":{"type":"string"},"words":{"type":"array","nullable":true,"items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"},"confidence":{"type":"number","nullable":true},"speaker":{"type":"string","nullable":true}},"required":["start","end","text","speaker"]}}},"required":["start","end","speaker","language","text"]}}},"required":["text","speakers","segments"],"description":"Included in `GET` responses for completed transcriptions."}},"required":["id","object","status","source","media","options","transcript_source","caption_kind","language","billed_minutes","cached","error","created_at","completed_at","deleted_at"],"example":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"youtube","url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","media_id":"dQw4w9WgXcQ"},"media":{"title":"Example video","author":"Example channel","author_url":"https://www.youtube.com/@examplechannel","thumbnail_url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","duration_seconds":212},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"youtube_captions","caption_kind":"auto_generated","language":"en","billed_minutes":4,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Welcome back to the channel. Today we are looking at how transcripts are made.","speakers":[],"segments":[{"start":0,"end":4.2,"speaker":null,"language":"en","text":"Welcome back to the channel."},{"start":4.2,"end":9.8,"speaker":null,"language":"en","text":"Today we are looking at how transcripts are made."}]}}},"TranscriptionList":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/Transcription"}},"next_cursor":{"type":"string","nullable":true}},"required":["object","data","next_cursor"]}},"parameters":{}},"paths":{"/account":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Get your account","description":"Returns the authenticated user, current plan and remaining transcription minutes.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"The authenticated user's account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"},"example":{"object":"account","user":{"id":"5b0e6c1c-0d6f-4c1f-9b5e-8f3f4d0a7a11","email":"you@example.com"},"plan":{"id":"9d4e0c0a-2b8a-4f0c-8d63-6a8d3c8a1f22","name":"Monthly"},"minutes":{"remaining":1180,"cycle":980,"topup":200,"topup_usable":true,"resets_at":"2026-11-13T09:30:00.000Z"},"renews_at":"2026-11-13T09:30:00.000Z","limits":{"requests_per_minute":200,"max_active_jobs":10}}}}},"401":{"description":"Missing or invalid credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"unauthorized","message":"Invalid session","retryable":false}}}}},"403":{"description":"Insufficient scope or a single-member team plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"insufficient_scope":{"summary":"insufficient_scope","value":{"error":{"code":"insufficient_scope","message":"OAuth scope is insufficient","retryable":false}}},"plan_single_member":{"summary":"plan_single_member","value":{"error":{"code":"plan_single_member","message":"This team plan only supports one active member. Contact your team admin to upgrade.","retryable":false}}}}}}},"404":{"description":"No account found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"not_found","message":"No account found for this credential","retryable":false}}}}},"429":{"description":"Too many requests. Wait for the number of seconds in `Retry-After`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"rate_limited","message":"Too many requests","retryable":true}}}}}}}},"/transcriptions":{"post":{"operationId":"createTranscription","tags":["Transcriptions"],"summary":"Create a transcription","description":"Transcribes an uploaded file or a YouTube, X, TikTok, Instagram, Facebook, Bluesky, Twitch, Dailymotion, Pinterest, LinkedIn, Snapchat link. Social posts must be public; only the first video is used.\n\nTwitch accepts clips and completed VODs; Pinterest accepts native video pins; LinkedIn accepts public video posts; Snapchat accepts Spotlight. New platforms require public recorded native media without supplied account cookies; no live streams or external embeds.\n\n`platform` is optional and detected from the link. Captions are available on YouTube, X, TikTok, Bluesky, Dailymotion and LinkedIn when a usable native track exists. Dailymotion supports direct SRT, not caption playlists; Bluesky captions require a supported trusted PDS; LinkedIn supports public native posts, not Learning. Other platforms use speech-to-text. Caption kind is null when authorship is unknown. All sources use the same per-minute price.\n\nReturns `200` for a final result, `201` when awaiting an upload and `202` while processing. Pass `wait` to wait up to 60 seconds for a final status.\n\nPass `reuse_recent=true` with a platform URL to reuse a transcription of the same video and options from the last 24 hours. The response includes `reused: true`, with no additional charge. Short links may not be matched. An `Idempotency-Key` replay takes precedence.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","nullable":true,"minimum":0,"maximum":60,"default":0,"description":"Seconds to wait for a final status before responding, up to 60. Defaults to 0."},"required":false,"name":"wait","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"For platform URLs only. Cannot be combined with `webhook_url`. Returns the team's most recent transcription of the same video with the same `source`, `language` and `diarize`. It must have been created in the last 24 hours and must not be `failed` or `canceled`. Reuses that transcription without creating or charging for a new one."},"required":false,"name":"reuse_recent","in":"query"},{"schema":{"type":"string","maxLength":255,"description":"Returns the original transcription when you repeat a request with the same key and parameters."},"required":false,"name":"Idempotency-Key","in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["youtube","x","tiktok","instagram","facebook","bluesky","twitch","dailymotion","pinterest","linkedin","snapchat"],"description":"Optional; detected from the link. If supplied, must match the link."},"url":{"type":"string","description":"YouTube, X, TikTok, Instagram, Facebook, Bluesky, Twitch, Dailymotion, Pinterest, LinkedIn, Snapchat video link. Social posts must be public; only the first video is used. New platforms support public recorded native video without supplied account cookies, not live streams or external embeds.","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"source":{"type":"string","enum":["auto","captions","stt"],"description":"\"auto\" uses native captions when available, otherwise speech-to-text. \"captions\" never falls back to speech-to-text and cannot be combined with diarize or uploads. \"stt\" always uses speech-to-text; diarize with auto skips captions. Captions are available on YouTube, X, TikTok, Bluesky, Dailymotion and LinkedIn when a usable native track exists. Dailymotion supports direct SRT, not caption playlists; Bluesky captions require a supported trusted PDS; LinkedIn supports public native posts, not Learning. Other platforms use speech-to-text. Caption kind is null when authorship is unknown."},"language":{"type":"string","example":"auto"},"diarize":{"type":"boolean"},"webhook_url":{"type":"string","format":"uri"}},"required":["url"]},{"type":"object","properties":{"upload":{"type":"object","properties":{"filename":{"type":"string","example":"interview.m4a"},"size":{"type":"integer","example":48210334},"mime_type":{"type":"string","example":"audio/mp4"}},"required":["filename","size"]},"source":{"type":"string","enum":["auto","stt"]},"language":{"type":"string","example":"auto"},"diarize":{"type":"boolean"},"webhook_url":{"type":"string","format":"uri"}},"required":["upload"]}]},"example":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"source":{"type":"string","enum":["auto","stt"]},"language":{"type":"string"},"diarize":{"type":"boolean"},"webhook_url":{"type":"string","format":"uri"}},"required":["file"]}}}},"responses":{"200":{"description":"The transcription reached a final status","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Transcription"},{"type":"object","properties":{"reused":{"type":"boolean","description":"`true` when `reuse_recent` returned an earlier transcription instead of creating a new one."}},"required":["reused"]}]},"example":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"youtube","url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","media_id":"dQw4w9WgXcQ"},"media":{"title":"Example video","author":"Example channel","author_url":"https://www.youtube.com/@examplechannel","thumbnail_url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","duration_seconds":212},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"youtube_captions","caption_kind":"auto_generated","language":"en","billed_minutes":4,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Welcome back to the channel. Today we are looking at how transcripts are made.","speakers":[],"segments":[{"start":0,"end":4.2,"speaker":null,"language":"en","text":"Welcome back to the channel."},{"start":4.2,"end":9.8,"speaker":null,"language":"en","text":"Today we are looking at how transcripts are made."}]},"reused":false}}}},"201":{"description":"The transcription is awaiting a chunked upload. `upload` describes where to send each chunk.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Transcription"},{"type":"object","properties":{"reused":{"type":"boolean","description":"`true` when `reuse_recent` returned an earlier transcription instead of creating a new one."}},"required":["reused"]},{"type":"object","properties":{"upload":{"type":"object","properties":{"chunk_url_template":{"type":"string","example":"https://api.transcript1.com/v1/transcriptions/tr_4fHq8ZbN2xLm0PqRsTuVwX/upload/chunks/{index}"},"headers":{"type":"object","properties":{"X-Upload-Token":{"type":"string","example":"t1u_Zk3vYb8Nw1ZrT5xLpD0aHcE7sUj9GfMiO2yXtVnR4Bw"}},"required":["X-Upload-Token"]},"expires_at":{"type":"string","format":"date-time"},"chunks":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"offset":{"type":"integer"},"size":{"type":"integer"}},"required":["index","offset","size"]}}},"required":["chunk_url_template","headers","expires_at","chunks"]}},"required":["upload"]}]},"example":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"awaiting_upload","source":{"platform":"upload","filename":"interview.m4a","size":48210334},"media":{"filename":"interview.m4a","mime_type":"audio/mp4","size":48210334},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":null,"caption_kind":null,"language":null,"billed_minutes":null,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":null,"deleted_at":null,"reused":false,"upload":{"chunk_url_template":"https://api.transcript1.com/v1/transcriptions/tr_4fHq8ZbN2xLm0PqRsTuVwX/upload/chunks/{index}","headers":{"X-Upload-Token":"t1u_Zk3vYb8Nw1ZrT5xLpD0aHcE7sUj9GfMiO2yXtVnR4Bw"},"expires_at":"2026-10-13T10:30:00.000Z","chunks":[{"index":0,"offset":0,"size":838860},{"index":1,"offset":838860,"size":838860},{"index":2,"offset":1677720,"size":838860},{"index":3,"offset":2516580,"size":838860},{"index":4,"offset":3355440,"size":838860},{"index":5,"offset":4194300,"size":8388608},{"index":6,"offset":12582908,"size":8388608},{"index":7,"offset":20971516,"size":8388608},{"index":8,"offset":29360124,"size":8388608},{"index":9,"offset":37748732,"size":8388608},{"index":10,"offset":46137340,"size":2072994}]}}}}},"202":{"description":"The transcription is processing","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Transcription"},{"type":"object","properties":{"reused":{"type":"boolean","description":"`true` when `reuse_recent` returned an earlier transcription instead of creating a new one."}},"required":["reused"]}]},"example":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"queued","source":{"platform":"youtube","url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","media_id":"dQw4w9WgXcQ"},"media":null,"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":null,"caption_kind":null,"language":null,"billed_minutes":null,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":null,"deleted_at":null,"reused":false}}}},"400":{"description":"The JSON request body is malformed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"invalid_request","message":"Request body is not valid JSON","retryable":false}}}}},"401":{"description":"Missing or invalid credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"unauthorized","message":"Invalid session","retryable":false}}}}},"402":{"description":"Not enough minutes. Applies to every request body format.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsufficientMinutesError"},"example":{"error":{"code":"insufficient_minutes","message":"Not enough minutes","retryable":false,"action_url":"https://transcript1.com/dashboard/billing","minutes_needed":12,"minutes_remaining":3}}}}},"403":{"description":"Insufficient scope, unverified email, cross-site request or a single-member team plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"insufficient_scope":{"summary":"insufficient_scope","value":{"error":{"code":"insufficient_scope","message":"OAuth scope is insufficient","retryable":false}}},"email_not_verified":{"summary":"email_not_verified","value":{"error":{"code":"email_not_verified","message":"Verify your email address to create transcriptions","retryable":false}}},"forbidden_origin":{"summary":"forbidden_origin","value":{"error":{"code":"forbidden_origin","message":"Cross-site request rejected","retryable":false}}},"plan_single_member":{"summary":"plan_single_member","value":{"error":{"code":"plan_single_member","message":"This team plan only supports one active member. Contact your team admin to upgrade.","retryable":false}}}}}}},"409":{"description":"`Idempotency-Key` was reused with different parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"idempotency_conflict","message":"Idempotency-Key was used with different parameters","retryable":false}}}}},"413":{"description":"The upload or the JSON request body is too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"media_too_large":{"summary":"media_too_large","value":{"error":{"code":"media_too_large","message":"File exceeds the maximum size","retryable":false,"max_bytes":95000000}}},"invalid_request":{"summary":"invalid_request","value":{"error":{"code":"invalid_request","message":"Request body is too large (max 1 MB)","retryable":false}}}}}}},"422":{"description":"Invalid request, URL, platform or file type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalid_request":{"summary":"invalid_request","value":{"error":{"code":"invalid_request","message":"Request validation failed","retryable":false,"params":{"wait":"Number must be less than or equal to 60"}}}},"invalid_url":{"summary":"invalid_url","value":{"error":{"code":"invalid_url","message":"Not a supported link. Use a YouTube, X, TikTok, Instagram, Facebook, Bluesky, Twitch, Dailymotion, Pinterest, LinkedIn, Snapchat link.","retryable":false}}},"unsupported_platform":{"summary":"unsupported_platform","value":{"error":{"code":"unsupported_platform","message":"Platform \"vimeo\" is not supported","retryable":false,"supported_platforms":["youtube","x","tiktok","instagram","facebook","bluesky","twitch","dailymotion","pinterest","linkedin","snapchat"]}}},"unsupported_media":{"summary":"unsupported_media","value":{"error":{"code":"unsupported_media","message":"Unsupported file type","retryable":false}}}}}}},"429":{"description":"Too many requests or too many active transcriptions. Wait for the number of seconds in `Retry-After`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rate_limited":{"summary":"rate_limited","value":{"error":{"code":"rate_limited","message":"Too many requests","retryable":true}}},"too_many_active_jobs":{"summary":"too_many_active_jobs","value":{"error":{"code":"too_many_active_jobs","message":"Too many active transcriptions (limit 2)","retryable":true}}}}}}}}},"get":{"operationId":"listTranscriptions","tags":["Transcriptions"],"summary":"List transcriptions","description":"Lists your team's transcriptions, newest first, without transcripts. Pass `next_cursor` as `cursor` to get the next page.\n\nDeleted transcriptions are hidden unless you pass `include_deleted=true`.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["awaiting_upload","queued","fetching","transcribing","completed","failed","canceled"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"platform","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Also returns deleted transcriptions as read-only records without a transcript. Their `deleted_at` is set. Defaults to `false`."},"required":false,"name":"include_deleted","in":"query"}],"responses":{"200":{"description":"A page of transcriptions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionList"},"example":{"object":"list","data":[{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"youtube","url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","media_id":"dQw4w9WgXcQ"},"media":{"title":"Example video","author":"Example channel","author_url":"https://www.youtube.com/@examplechannel","thumbnail_url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","duration_seconds":212},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"youtube_captions","caption_kind":"auto_generated","language":"en","billed_minutes":4,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null}],"next_cursor":"eyJjcmVhdGVkQXQiOiIyMDI2LTEwLTEzVDA5OjMwOjAwLjAwMFoiLCJpZCI6IjViMGU2YzFjLTBkNmYtNGMxZi05YjVlLThmM2Y0ZDBhN2ExMSJ9"}}}},"401":{"description":"Missing or invalid credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"unauthorized","message":"Invalid session","retryable":false}}}}},"403":{"description":"Insufficient scope or a single-member team plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"insufficient_scope":{"summary":"insufficient_scope","value":{"error":{"code":"insufficient_scope","message":"OAuth scope is insufficient","retryable":false}}},"plan_single_member":{"summary":"plan_single_member","value":{"error":{"code":"plan_single_member","message":"This team plan only supports one active member. Contact your team admin to upgrade.","retryable":false}}}}}}},"422":{"description":"Invalid query parameters or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"invalid_request","message":"Invalid cursor","retryable":false}}}}},"429":{"description":"Too many requests. Wait for the number of seconds in `Retry-After`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":{"code":"rate_limited","message":"Too many requests","retryable":true}}}}}}}},"/transcriptions/{id}":{"get":{"operationId":"getTranscription","tags":["Transcriptions"],"summary":"Get a transcription","description":"Returns the transcription object. Completed transcriptions include the transcript. Use `format` to render it as text, SRT or WebVTT.\n\nIf you request a rendered format before completion, the response is JSON. It returns `202` while processing or `200` if the transcription failed or was canceled.\n\nWith `include_deleted=true`, a deleted transcription is returned as a record without a transcript. For deleted records, `wait` is ignored and rendered formats return `404`.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","example":"tr_4fHq8ZbN2xLm0PqRsTuVwX"},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","nullable":true,"minimum":0,"maximum":60,"default":0,"description":"Seconds to wait for a final status before responding, up to 60. Defaults to 0."},"required":false,"name":"wait","in":"query"},{"schema":{"type":"string","enum":["json","text","srt","vtt"],"default":"json"},"required":false,"name":"format","in":"query"},{"schema":{"type":"string","enum":["words"]},"required":false,"name":"include","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"timestamps","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Also returns deleted transcriptions as read-only records without a transcript. Their `deleted_at` is set. Defaults to `false`."},"required":false,"name":"include_deleted","in":"query"}],"responses":{"200":{"description":"The transcription, or the rendered transcript","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transcription"},"examples":{"completed":{"summary":"Completed","value":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"youtube","url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","media_id":"dQw4w9WgXcQ"},"media":{"title":"Example video","author":"Example channel","author_url":"https://www.youtube.com/@examplechannel","thumbnail_url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","duration_seconds":212},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"youtube_captions","caption_kind":"auto_generated","language":"en","billed_minutes":4,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Welcome back to the channel. Today we are looking at how transcripts are made.","speakers":[],"segments":[{"start":0,"end":4.2,"speaker":null,"language":"en","text":"Welcome back to the channel."},{"start":4.2,"end":9.8,"speaker":null,"language":"en","text":"Today we are looking at how transcripts are made."}]}}},"tiktok":{"summary":"tiktok captions (unknown authorship)","value":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"tiktok","url":"https://www.tiktok.com/@example/video/6718335390845095173","media_id":"6718335390845095173"},"media":{"title":"Example native video","duration_seconds":10},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"tiktok_captions","caption_kind":null,"language":"en","billed_minutes":1,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Example native captions.","speakers":[],"segments":[{"start":0,"end":3,"speaker":null,"language":"en","text":"Example native captions.","words":null}]}}},"bluesky":{"summary":"bluesky captions (unknown authorship)","value":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"bluesky","url":"https://bsky.app/profile/example.bsky.social/post/3lbpqwzq2bk2j","media_id":"example.bsky.social/3lbpqwzq2bk2j"},"media":{"title":"Example native video","duration_seconds":10},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"bluesky_captions","caption_kind":null,"language":"en","billed_minutes":1,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Example native captions.","speakers":[],"segments":[{"start":0,"end":3,"speaker":null,"language":"en","text":"Example native captions.","words":null}]}}},"dailymotion":{"summary":"dailymotion captions (unknown authorship)","value":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"dailymotion","url":"https://www.dailymotion.com/video/x123","media_id":"x123"},"media":{"title":"Example native video","duration_seconds":10},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"dailymotion_captions","caption_kind":null,"language":"en","billed_minutes":1,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","deleted_at":null,"transcript":{"text":"Example native captions.","speakers":[],"segments":[{"start":0,"end":3,"speaker":null,"language":"en","text":"Example native captions.","words":null}]}}},"linkedin":{"summary":"linkedin captions (unknown authorship)","value":{"id":"tr_4fHq8ZbN2xLm0PqRsTuVwX","object":"transcription","status":"completed","source":{"platform":"linkedin","url":"https://www.linkedin.com/feed/update/urn:li:activity:123/","media_id":"123"},"media":{"title":"Example native video","duration_seconds":10},"options":{"source":"auto","language":"auto","diarize":false},"transcript_source":"linkedin_captions","caption_kind":null,"language":"en","billed_minutes":1,"cached":false,"error":null,"created_at":"2026-10-13T09:30:00.000Z","completed_at":"2026-10-13T09:30:04.000Z","de

# --- truncated at 32 KB (46 KB total) ---
# Full source: https://artifacts.apis.io/transcriptapi-io/openapi/transcriptapi-io-openapi.json