Skip to content

TranscriptFor developers, content & research

Convert a YouTube transcript to SRT, Markdown or plain text

Get a YouTube, TikTok or Instagram transcript as plain text, Markdown with timestamp links, or an SRT subtitle file, with a short Python script for each.

1 min readBy CleanScriptView as Markdown

On this page
  1. Plain text
  2. Markdown with timestamp links
  3. SRT subtitles
  4. Before you publish subtitles
  5. Next steps

One transcript request gives you everything for plain text, Markdown and SRT. Plain text is one SDK call; Markdown and SRT take a few lines of code, so you control how they look.

Ask for lines so you have caption times:

Python
# pip install cleanscript-ai
from cleanscript_ai import CleanScript, transcript_text

client = CleanScript()
result = client.transcript("https://youtu.be/jwnez8HdN7E", include=["lines"])

Plain text #

Python
open("transcript.txt", "w").write(transcript_text(result))

transcript_text gives the paragraphs separated by blank lines, with punctuation and capitals. Add "text" to include and the response carries the same string as text.

A heading per section, linked to its start, with the paragraphs under it:

Python
def stamp(seconds):
    m, s = divmod(int(seconds), 60)
    return f"{m}:{s:02}"

post = result.post
out = [f"# {post.title or post.description}", f"By {post.author.name}. [Watch]({post.url})", ""]
for section in result.sections:
    out.append(f"## [{stamp(section.start)}]({section.url}) {section.title or ''}".strip())
    out += [p.text + "\n" for p in section.paragraphs]
open("transcript.md", "w").write("\n".join(out))

post.title exists only on YouTube; TikTok and Instagram have a caption instead, in post.description. On those platforms a section's url is the post link, since their links can't open at a moment.

SRT subtitles #

SRT numbers each block and gives it a start and end as hh:mm:ss,mmm:

Python
def srt_time(seconds):
    ms = round(seconds * 1000)
    h, ms = divmod(ms, 3_600_000)
    m, ms = divmod(ms, 60_000)
    s, ms = divmod(ms, 1000)
    return f"{h:02}:{m:02}:{s:02},{ms:03}"

blocks = (
    f"{i}\n{srt_time(line.start)} --> {srt_time(line.end)}\n{line.text}\n"
    for i, line in enumerate(result.lines, 1)
)
open("subtitles.srt", "w").write("\n".join(blocks))

Run on Le Monde's TikTok about its explainer videos, the file starts:

Text
1
00:00:00,080 --> 00:00:04,560
Comment réalisons nos vidéos verticales au Monde ? Bienvenue dans notre open space.

2
00:00:04,680 --> 00:00:08,880
C'est ici qu'on fabrique les vidéos d'explication qui sont publiées sur les réseaux sociaux du journal

3
00:00:09,040 --> 00:00:12,760
le monde. On existe depuis deux-mille-seize, et avant ça ressemblait à ça,

Lines are short, a few seconds each (up to about 5; creator captions keep their own lines), so they work as subtitles as they are.

Before you publish subtitles #

Corrected automatic captions still contain some errors, so read the file once before you upload it. If the video isn't yours, keep the file for your own use.

Next steps #

Spot something wrong? Tell us.