--- title: "YouTube Transcript" short_description: "Existing YouTube transcript text with timestamps." emoji: "🔎" colorFrom: "blue" colorTo: "indigo" sdk: "static" app_file: "index.html" pinned: false license: "mit" tags: - smolagents - tool - flashdata - youtube-transcript --- # YouTube Transcript Retrieve existing YouTube transcript text and timestamped segments by video ID and language. Automatic captions are selected by default. [API documentation](https://flashdata.dev/docs/sources/youtube_transcript?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-transcript-research-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task) Requires your own FlashData API key and paid Credits. The Python tool is free to install. ## Try the inputs Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key. ## Run with Python Use Python 3.10 or newer: ```sh python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1" ``` Review [tool.py](tool.py) before enabling `trust_remote_code`. Run locally with your key: ```python import getpass import os from smolagents import load_tool os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ") tool = load_tool("flashdata-dev/youtube-transcript-research-flashdata", trust_remote_code=True) result = tool(**{'auto': True, 'language': 'en', 'video_id': 'FUfGcZ092b0'}) print(result) ``` The same loaded tool can be used with smolagents. A direct Python call does not require a model. ## Inputs | Parameter | Required / default | Details | | --- | --- | --- | | `video_id` | Required | 11-character YouTube video ID or a YouTube video URL. | | `language` | 'en' | Requested caption language code. | | `auto` | True | True requests automatic captions; false requests manually authored captions. | See [input-schema.json](input-schema.json) for full validation rules. Optional `None` values are omitted; adapter defaults apply. ## Output Read `results.0.segments`. Fields: `start`, `end`, `text`. Optional fields may be absent. [example.json](example.json) contains a recorded response and its original request, not a new result for the input shown in the Space. ## Limits and cost Defaults to existing English automatic captions. No speech recognition, translation or fallback to another track; unavailable tracks fail. Each data request uses FlashData Credits. Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_transcript-task) before running. Any model or hosting charges are separate. For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions.