Get video transcript - KonbiniAPI Docs

What it does

Returns the transcript for a public video, in WebVTT format. Without language, returns the channel-set default track, or the first available one if none is set. Use the captions field on the video-detail endpoint to see which languages exist before requesting one.

Tool details

Field	Value
Tool name	`youtube_get_video_transcript`
Platform	YouTube
REST endpoint	`GET /v1/youtube/videos/{videoId}/transcript`
Result type	Detail tool

Parameters

Parameter	Type	Required	Description
`videoId`	`string`	Yes	YouTube video ID (the `v=` value from a watch URL)
`language`	`string`	No	Language code of the caption track to return (as listed in the video-detail endpoint’s captions[].languageCode). Defaults to the channel-set default track.
`projection_preset`	`string`	No	Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`.
`data_fields`	`string[]`	No	Adds top-level keys from `data` on top of the selected `projection_preset`.

Example

{
  "name": "youtube_get_video_transcript",
  "arguments": {
    "videoId": "plN7JMbadRg",
    "projection_preset": "minimal",
    "data_fields": [
      "content",
      "url",
      "type",
      "id"
    ]
  }
}

Available data fields

@context
type
id
url
mediaType
language
size
source
content

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.