getTranscripts
Retrieve video transcripts from YouTube, focusing on key segments like intro hooks and final calls to action, or get full text for analysis.
Instructions
Retrieves specific, meaningful segments of a video's transcript. By default, it returns the intro 'hook' and the final 'outro' or call to action. It can also return the full transcript text. Use this to efficiently analyze a video's key messaging.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
format | No | The desired transcript format. 'full_text': Returns the entire transcript as a single string. 'key_segments': (Default) Returns only the video's intro hook and final call to action. | key_segments |
lang | No | Language code for transcripts (e.g., 'en', 'ko', 'es'). Defaults to environment setting or 'en' | en |
videoIds | Yes | Array of YouTube video IDs to get transcripts for |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"format": {
"default": "key_segments",
"description": "The desired transcript format. 'full_text': Returns the entire transcript as a single string. 'key_segments': (Default) Returns only the video's intro hook and final call to action.",
"enum": [
"full_text",
"key_segments"
],
"type": "string"
},
"lang": {
"default": "en",
"description": "Language code for transcripts (e.g., 'en', 'ko', 'es'). Defaults to environment setting or 'en'",
"type": "string"
},
"videoIds": {
"description": "Array of YouTube video IDs to get transcripts for",
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
}
},
"required": [
"videoIds"
],
"type": "object"
}