File size: 3,192 Bytes
9bf6095 43ae5be 9bf6095 43ae5be 87b4224 9bf6095 43ae5be 87b4224 43ae5be 87b4224 e7650a6 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 43ae5be 87b4224 e7650a6 87b4224 43ae5be | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | ---
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.
|