How to Use YouTube transcript in Codex
Fetch a public YouTube video's or Short's captions as timed segments and plain text. Use it to summarize spoken content, find passages, or build searchable notes when YouTube exposes a matching caption track.
Prompts to try with YouTube transcript in Codex
Copy an example into Codex, or ask in your own words.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=WUvTyaaNkzM. Add a searchable reference page to this project with matching passages and timestamps.
Use YouTube video transcript for freeCodeCamp's https://www.youtube.com/watch?v=rfscVS0vtbw. Create a JSON fixture containing the returned timed segments and plain text, preserving the source wording.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=3b_qM4o5nWo. Write a Markdown study guide in this repository with definitions and supporting timestamps.
Use YouTube video transcript for freeCodeCamp's https://www.youtube.com/watch?v=rfscVS0vtbw. Build a small transcript viewer in this project that filters caption segments by a search phrase.
Use YouTube video transcript for 3Blue1Brown's https://www.youtube.com/watch?v=WUvTyaaNkzM. Add transcript-based question answering to this project and show the supporting passage and timestamp with each answer.
How to set up YouTube transcript in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run YouTube transcript
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/youtube-transcript", "input": { "url": "https://www.youtube.com/watch?v=bjVIDXPP7Uk" } }'
Then paste one of the prompts above: Codex finds YouTube transcript on Spiral, shows the price and runs it.
YouTube transcript providers and prices
Spiral runs YouTube transcript through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Cache max age | 1d, 3d, 7d, 14d, or 30d | Return ScrapeCreators' cached answer when it is at most this old (0 credits, with | |
| Original audio | on or off | Return captions only in the original spoken language YouTube identified. Takes precedence over |
Every API field of YouTube transcript is on its tool page: open its card above.
What can you do with YouTube transcript in Codex?
Build a searchable reference for public YouTube lectures and tutorials, with each result tied to a caption timestamp. A coding agent can turn transcript responses into project fixtures, search records, and documentation.
Lecture notes with timestamps
Turn a public lecture's caption segments into an outline, definitions, and review questions. Attach timestamps so readers can return to the relevant explanation.
Searchable video references
Index transcript text from selected public videos and return matching passages with their segment times.
Product announcement briefs
Extract product names, stated features, and commitments from a company's public announcement video, with a timestamp for each supporting passage.
Tutorial checklists
Convert a tutorial's spoken instructions into an ordered checklist. Link each step to the caption passage that explains it.
Caption revision review
Compare successive transcript responses for a selected video and flag changed wording or timing for review.
Creator content planning
Use a creator's own captioned videos to draft chapter suggestions, newsletter outlines, and short clip candidates grounded in spoken passages.
YouTube transcript success rate and speed on Spiral
Success and speed over the last 24 hours, across every run of these tools on Spiral.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| YouTube transcript | 100.0% | 5.9s | 32 |
More on YouTube transcript and Codex
Overview
YouTube transcript in other agents
Questions about YouTube transcript in Codex
Can Codex use YouTube transcript?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run YouTube transcript like any built-in tool.
How much does YouTube transcript cost in Codex?
Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a ScrapeCreators account to use YouTube transcript in Codex?
No. Spiral runs YouTube transcript on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up YouTube transcript in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while YouTube transcript runs?
YouTube transcript runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
Does every public YouTube video have a transcript?
No. The endpoint retrieves public caption tracks from videos and Shorts, and a missing matching track produces a null transcript. It has no AI transcription fallback.
Can it retrieve captions from an hour-long lecture?
Yes, if YouTube exposes public captions. ScrapeCreators documents support for videos of any length, so an hour-long lecture is within its stated coverage.
Are captions available immediately after upload?
Not always. YouTube says automatic captions may still be processing when a video is uploaded, with timing dependent on audio complexity. Creators can also revise caption text and timing later.
How accurate are YouTube's automatic captions?
YouTube identifies pronunciation, accents, dialects, and background noise as causes of transcription errors. Check important quotations against the audio before using them as exact statements.
Does YouTube automatically caption every language track?
No. YouTube says automatic captions are in the video's default language only. The transcript endpoint returns null when the requested language has no matching captions.
Start using YouTube transcript in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


