Repository navigation
Expand file tree
/
Copy pathbasic_extraction.py
More file actions
76 lines (58 loc) · 2.08 KB
/
Copy pathbasic_extraction.py
File metadata and controls
76 lines (58 loc) · 2.08 KB
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
"""
Basic YouTube Transcript Extraction (V2 API)
==============================================
Extract a timestamped transcript from any YouTube video.
Get your free API key at: https://youtubetranscript.dev
Requirements:
pip install requests
"""
import requests
import sys
API_KEY = "your_api_key_here" # Get yours at https://youtubetranscript.dev
BASE_URL = "https://www.youtubetranscript.dev/api/v2"
def extract_transcript(video: str, language: str = None) -> dict:
"""
Extract a transcript from a YouTube video.
Args:
video: YouTube URL or 11-character video ID
language: Optional ISO 639-1 code (e.g., "es", "fr"). Omit for best available.
"""
payload = {
"video": video,
"format": {"timestamp": True}, # include timed segments
}
if language:
payload["language"] = language
response = requests.post(
f"{BASE_URL}/transcribe",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
)
response.raise_for_status()
return response.json()
def format_timestamp(ms: int) -> str:
"""Convert milliseconds to MM:SS format."""
mins, secs = divmod(ms // 1000, 60)
return f"{mins:02d}:{secs:02d}"
def main():
video = sys.argv[1] if len(sys.argv) > 1 else "dQw4w9WgXcQ"
print(f"Extracting transcript for: {video}\n")
result = extract_transcript(video)
if result.get("status") == "completed":
data = result["data"]
transcript = data["transcript"]
segments = transcript.get("segments") or []
print(f"Title: {data.get('video_title')}")
print(f"Language: {transcript.get('language', 'N/A')} ({transcript.get('source')})")
print(f"Segments: {len(segments)}")
print("-" * 50)
for segment in segments:
timestamp = format_timestamp(segment["start"])
print(f"[{timestamp}] {segment['text']}")
else:
print(f"Status: {result.get('status')} {result.get('error', '')}")
if __name__ == "__main__":
main()