82 |
238 |
239 |
240 |
--------------------------------------------------------------------------------
/youtube_transcript_api/formatters.py:
--------------------------------------------------------------------------------
1 | import json
2 |
3 | import pprint
4 | from typing import List, Iterable
5 |
6 | from ._transcripts import FetchedTranscript, FetchedTranscriptSnippet
7 |
8 |
9 | class Formatter:
10 | """Formatter should be used as an abstract base class.
11 |
12 | Formatter classes should inherit from this class and implement
13 | their own .format() method which should return a string. A
14 | transcript is represented by a List of Dictionary items.
15 | """
16 |
17 | def format_transcript(self, transcript: FetchedTranscript, **kwargs) -> str:
18 | raise NotImplementedError(
19 | "A subclass of Formatter must implement "
20 | "their own .format_transcript() method."
21 | )
22 |
23 | def format_transcripts(self, transcripts: List[FetchedTranscript], **kwargs):
24 | raise NotImplementedError(
25 | "A subclass of Formatter must implement "
26 | "their own .format_transcripts() method."
27 | )
28 |
29 |
30 | class PrettyPrintFormatter(Formatter):
31 | def format_transcript(self, transcript: FetchedTranscript, **kwargs) -> str:
32 | """Pretty prints a transcript.
33 |
34 | :param transcript:
35 | :return: A pretty printed string representation of the transcript.
36 | """
37 | return pprint.pformat(transcript.to_raw_data(), **kwargs)
38 |
39 | def format_transcripts(self, transcripts: List[FetchedTranscript], **kwargs) -> str:
40 | """Converts a list of transcripts into a JSON string.
41 |
42 | :param transcripts:
43 | :return: A JSON string representation of the transcript.
44 | """
45 | return pprint.pformat(
46 | [transcript.to_raw_data() for transcript in transcripts], **kwargs
47 | )
48 |
49 |
50 | class JSONFormatter(Formatter):
51 | def format_transcript(self, transcript: FetchedTranscript, **kwargs) -> str:
52 | """Converts a transcript into a JSON string.
53 |
54 | :param transcript:
55 | :return: A JSON string representation of the transcript.
56 | """
57 | return json.dumps(transcript.to_raw_data(), **kwargs)
58 |
59 | def format_transcripts(self, transcripts: List[FetchedTranscript], **kwargs) -> str:
60 | """Converts a list of transcripts into a JSON string.
61 |
62 | :param transcripts:
63 | :return: A JSON string representation of the transcript.
64 | """
65 | return json.dumps(
66 | [transcript.to_raw_data() for transcript in transcripts], **kwargs
67 | )
68 |
69 |
70 | class TextFormatter(Formatter):
71 | def format_transcript(self, transcript: FetchedTranscript, **kwargs) -> str:
72 | """Converts a transcript into plain text with no timestamps.
73 |
74 | :param transcript:
75 | :return: all transcript text lines separated by newline breaks.
76 | """
77 | return "\n".join(line.text for line in transcript)
78 |
79 | def format_transcripts(self, transcripts: List[FetchedTranscript], **kwargs) -> str:
80 | """Converts a list of transcripts into plain text with no timestamps.
81 |
82 | :param transcripts:
83 | :return: all transcript text lines separated by newline breaks.
84 | """
85 | return "\n\n\n".join(
86 | [self.format_transcript(transcript, **kwargs) for transcript in transcripts]
87 | )
88 |
89 |
90 | class _TextBasedFormatter(TextFormatter):
91 | def _format_timestamp(self, hours: int, mins: int, secs: int, ms: int) -> str:
92 | raise NotImplementedError(
93 | "A subclass of _TextBasedFormatter must implement "
94 | "their own .format_timestamp() method."
95 | )
96 |
97 | def _format_transcript_header(self, lines: Iterable[str]) -> str:
98 | raise NotImplementedError(
99 | "A subclass of _TextBasedFormatter must implement "
100 | "their own _format_transcript_header method."
101 | )
102 |
103 | def _format_transcript_helper(
104 | self, i: int, time_text: str, snippet: FetchedTranscriptSnippet
105 | ) -> str:
106 | raise NotImplementedError(
107 | "A subclass of _TextBasedFormatter must implement "
108 | "their own _format_transcript_helper method."
109 | )
110 |
111 | def _seconds_to_timestamp(self, time: float) -> str:
112 | """Helper that converts `time` into a transcript cue timestamp.
113 |
114 | :reference: https://www.w3.org/TR/webvtt1/#webvtt-timestamp
115 |
116 | :param time: a float representing time in seconds.
117 | :type time: float
118 | :return: a string formatted as a cue timestamp, 'HH:MM:SS.MS'
119 | :example:
120 | >>> self._seconds_to_timestamp(6.93)
121 | '00:00:06.930'
122 | """
123 | time = float(time)
124 | hours_float, remainder = divmod(time, 3600)
125 | mins_float, secs_float = divmod(remainder, 60)
126 | hours, mins, secs = int(hours_float), int(mins_float), int(secs_float)
127 | ms = int(round((time - int(time)) * 1000, 2))
128 | return self._format_timestamp(hours, mins, secs, ms)
129 |
130 | def format_transcript(self, transcript: FetchedTranscript, **kwargs) -> str:
131 | """A basic implementation of WEBVTT/SRT formatting.
132 |
133 | :param transcript:
134 | :reference:
135 | https://www.w3.org/TR/webvtt1/#introduction-caption
136 | https://www.3playmedia.com/blog/create-srt-file/
137 | """
138 | lines = []
139 | for i, line in enumerate(transcript):
140 | end = line.start + line.duration
141 | time_text = "{} --> {}".format(
142 | self._seconds_to_timestamp(line.start),
143 | self._seconds_to_timestamp(
144 | transcript[i + 1].start
145 | if i < len(transcript) - 1 and transcript[i + 1].start < end
146 | else end
147 | ),
148 | )
149 | lines.append(self._format_transcript_helper(i, time_text, line))
150 |
151 | return self._format_transcript_header(lines)
152 |
153 |
154 | class SRTFormatter(_TextBasedFormatter):
155 | def _format_timestamp(self, hours: int, mins: int, secs: int, ms: int) -> str:
156 | return "{:02d}:{:02d}:{:02d},{:03d}".format(hours, mins, secs, ms)
157 |
158 | def _format_transcript_header(self, lines: Iterable[str]) -> str:
159 | return "\n\n".join(lines) + "\n"
160 |
161 | def _format_transcript_helper(
162 | self, i: int, time_text: str, snippet: FetchedTranscriptSnippet
163 | ) -> str:
164 | return "{}\n{}\n{}".format(i + 1, time_text, snippet.text)
165 |
166 |
167 | class WebVTTFormatter(_TextBasedFormatter):
168 | def _format_timestamp(self, hours: int, mins: int, secs: int, ms: int) -> str:
169 | return "{:02d}:{:02d}:{:02d}.{:03d}".format(hours, mins, secs, ms)
170 |
171 | def _format_transcript_header(self, lines: Iterable[str]) -> str:
172 | return "WEBVTT\n\n" + "\n\n".join(lines) + "\n"
173 |
174 | def _format_transcript_helper(
175 | self, i: int, time_text: str, snippet: FetchedTranscriptSnippet
176 | ) -> str:
177 | return "{}\n{}".format(time_text, snippet.text)
178 |
179 |
180 | class FormatterLoader:
181 | TYPES = {
182 | "json": JSONFormatter,
183 | "pretty": PrettyPrintFormatter,
184 | "text": TextFormatter,
185 | "webvtt": WebVTTFormatter,
186 | "srt": SRTFormatter,
187 | }
188 |
189 | class UnknownFormatterType(Exception):
190 | def __init__(self, formatter_type: str):
191 | super().__init__(
192 | "The format '{formatter_type}' is not supported. "
193 | "Choose one of the following formats: {supported_formatter_types}".format(
194 | formatter_type=formatter_type,
195 | supported_formatter_types=", ".join(FormatterLoader.TYPES.keys()),
196 | )
197 | )
198 |
199 | def load(self, formatter_type: str = "pretty") -> Formatter:
200 | """
201 | Loads the Formatter for the given formatter type.
202 |
203 | :param formatter_type:
204 | :return: Formatter object
205 | """
206 | if formatter_type not in FormatterLoader.TYPES.keys():
207 | raise FormatterLoader.UnknownFormatterType(formatter_type)
208 | return FormatterLoader.TYPES[formatter_type]()
209 |
--------------------------------------------------------------------------------
/youtube_transcript_api/test/assets/youtube_video_unavailable.innertube.json.static:
--------------------------------------------------------------------------------
1 | {
2 | "responseContext": {
3 | "visitorData": "CgtkVnYwR1MzN3pQTSjGu6bCBjIKCgJERRIEEgAgLjoMCAEgzKLJvOe456RoWJff7Nfpi977SA%3D%3D",
4 | "serviceTrackingParams": [
5 | {
6 | "service": "GFEEDBACK",
7 | "params": [
8 | {
9 | "key": "is_viewed_live",
10 | "value": "False"
11 | },
12 | {
13 | "key": "logged_in",
14 | "value": "0"
15 | },
16 | {
17 | "key": "e",
18 | "value": "9406121,23888716,24004644,24077241,24078649,24104894,24132305,24143331,24166867,24181174,24230811,24232551,24241378,24290153,24397985,24484132,24522874,24556101,24585737,39325413,39328442,39328646,51010008,51020570,51025415,51054999,51067700,51068313,51080128,51086511,51095478,51115184,51129105,51132535,51137671,51141472,51152050,51175149,51179435,51179748,51183208,51183910,51217334,51224491,51227037,51237842,51242448,51248777,51256074,51272458,51295372,51303432,51306453,51313109,51313767,51314496,51324733,51326139,51349914,51353393,51354083,51354114,51356621,51366423,51366620,51372971,51375205,51375719,51386541,51388661,51397332,51398647,51402689,51404808,51404810,51420457,51421832,51428417,51428624,51429106,51430311,51432294,51432529,51432560,51436956,51437205,51439763,51439874,51441100,51442501,51443707,51447191,51452420,51453239,51456413,51456629,51458927,51459424,51460559,51461268,51462839,51463930,51466698,51466900,51467076,51467525,51469820,51471138,51471685,51475592,51475960,51478931,51479781,51483631,51483888,51484221,51484412,51484746,51485249,51485417,51486018,51486471,51487681,51489047,51490158,51491436,51492252,51495585,51495706,51495859,51497133,51498591,51503024,51503027,51504828,51506681,51506715,51507237,51508739,51508979,51509214,51509314,51509614,51512708"
19 | },
20 | {
21 | "key": "visitor_data",
22 | "value": "CgtkVnYwR1MzN3pQTSjGu6bCBjIKCgJERRIEEgAgLjoMCAEgzKLJvOe456Ro"
23 | }
24 | ]
25 | },
26 | {
27 | "service": "CSI",
28 | "params": [
29 | {
30 | "key": "c",
31 | "value": "ANDROID"
32 | },
33 | {
34 | "key": "cver",
35 | "value": "20.10.38"
36 | },
37 | {
38 | "key": "yt_li",
39 | "value": "0"
40 | },
41 | {
42 | "key": "GetPlayer_rid",
43 | "value": "0xfa514d3157e18a41"
44 | }
45 | ]
46 | },
47 | {
48 | "service": "GUIDED_HELP",
49 | "params": [
50 | {
51 | "key": "logged_in",
52 | "value": "0"
53 | }
54 | ]
55 | },
56 | {
57 | "service": "ECATCHER",
58 | "params": [
59 | {
60 | "key": "client.version",
61 | "value": "20.10"
62 | },
63 | {
64 | "key": "client.name",
65 | "value": "ANDROID"
66 | }
67 | ]
68 | },
69 | {
70 | "service": "LISTNR",
71 | "params": [
72 | {
73 | "key": "e",
74 | "value": "51498591,51183208,24181216,51366423,51248777,51397332,51478931,24522874,51442501,51175149,51388661,24024517,51508739,51466900,51479781,51486471,51461268,51495585,51421832,51375205,24195012,51439763,51504828,51441100,51489047,51189308,51020570,51086511,51456413,51306453,51353393,51137671,51313767,51430311,51354114,51217334,51469823,51471138,51490158,51303432,51054999,51461791,51467525,51429106,24104894,51466698,39328646,51237842,51506715,24181174,51475960,51469820,51483888,51010008,51486018,51506681,39325413,51179748,51483631,51404808,51375719,51484412,51452420,24143331,51467076,24290153,51492252,51507237,51314496,51491436,51436956,51512708,51256074,51461795,51067700,51485417,51495706,51402689,24033252,51295372,51428417,24397985,51272458,51484746,51453239,51192010,51459424,51432294,51484221,51503027,24585737,51432560,51354083,24556101,24166867,51509214,51475592,24254870,51485249,51132535,51324733,51509314,51179435,51428624,51447191,24220751,51270362,24250570,51372971,51509614,51456629,51497133,51202133,51242448,51349914,51387900,51439874,51080128,51443707,24232551,51025415,51458927,51462839,24230811,51129105,51141472,51404810,51095478,51463930,51495859,51152050,51508979,51420457,51313109,24286257,51366620,39328442"
75 | }
76 | ]
77 | }
78 | ],
79 | "maxAgeSeconds": 0,
80 | "rolloutToken": "CMimoJKC4PuILBDn0eTd1OmNAxjn0eTd1OmNAw%3D%3D"
81 | },
82 | "playabilityStatus": {
83 | "status": "ERROR",
84 | "reason": "This video is unavailable",
85 | "errorScreen": {
86 | "playerErrorMessageRenderer": {
87 | "reason": {
88 | "runs": [
89 | {
90 | "text": "This video is unavailable"
91 | }
92 | ]
93 | },
94 | "thumbnail": {
95 | "thumbnails": [
96 | {
97 | "url": "//s.ytimg.com/yts/img/meh7-vflGevej7.png",
98 | "width": 140,
99 | "height": 100
100 | }
101 | ]
102 | },
103 | "icon": {
104 | "iconType": "ERROR_OUTLINE"
105 | }
106 | }
107 | },
108 | "contextParams": "Q0FBU0FnZ0E="
109 | },
110 | "trackingParams": "CAAQu2kiEwi20OTd1OmNAxUY-UIFHVxGIYo=",
111 | "onResponseReceivedActions": [
112 | {
113 | "clickTrackingParams": "CAAQu2kiEwi20OTd1OmNAxUY-UIFHVxGIYo=",
114 | "startEomFlowCommand": {
115 | "eomFlowRenderer": {
116 | "webViewRenderer": {
117 | "url": {
118 | "privateDoNotAccessOrElseTrustedResourceUrlWrappedValue": "https://consent.youtube.com/yt-app-main?gl=DE&m=1&pc=yt&cm=2&hl=en&src=1&app=1&vd=CgtkVnYwR1MzN3pQTSjGu6bCBjIKCgJERRIEEgAgLjoMCAEgzKLJvOe456Ro&utm_source=YT_ANDROID&dt=0&av=20.10.38"
119 | },
120 | "onFailureCommand": {
121 | "clickTrackingParams": "CAIQmawJIhMIttDk3dTpjQMVGPlCBR1cRiGK",
122 | "updateEomStateCommand": {
123 | "mobileEomFlowState": {
124 | "updatedVisitorData": "CgtkVnYwR1MzN3pQTSjGu6bCBjIKCgJERRIEEgAgLjoaCAEaDAjGu6bCBhDA5v3UAiDMosm857jnpGg%3D",
125 | "isError": true
126 | }
127 | }
128 | },
129 | "trackingParams": "CAIQmawJIhMIttDk3dTpjQMVGPlCBR1cRiGK",
130 | "webViewEntityKey": "Eg5Fb21GbG93V2VidmlldyD4AigB",
131 | "webToNativeMessageMap": [
132 | {
133 | "key": "sign_in_endpoint",
134 | "value": {
135 | "clickTrackingParams": "CAIQmawJIhMIttDk3dTpjQMVGPlCBR1cRiGK",
136 | "signInEndpoint": {
137 | "hack": true
138 | }
139 | }
140 | },
141 | {
142 | "key": "update_eom_state_command",
143 | "value": {
144 | "clickTrackingParams": "CAIQmawJIhMIttDk3dTpjQMVGPlCBR1cRiGK",
145 | "updateEomStateCommand": {
146 | "hack": true
147 | }
148 | }
149 | }
150 | ],
151 | "webViewUseCase": "WEB_VIEW_USE_CASE_EOM_CONSENT",
152 | "openInBrowserUrls": [
153 | "https://policies.google.com",
154 | "https://support.google.com"
155 | ],
156 | "firstPartyHostNameAllowList": [
157 | "consent.youtube.com"
158 | ]
159 | }
160 | },
161 | "consentMoment": "CONSENT_MOMENT_INITIAL"
162 | }
163 | }
164 | ],
165 | "playerSettingsMenuData": {
166 | "loggingDirectives": {
167 | "trackingParams": "CAEQtc4GIhMIttDk3dTpjQMVGPlCBR1cRiGK",
168 | "visibility": {
169 | "types": "12"
170 | }
171 | }
172 | },
173 | "frameworkUpdates": {
174 | "entityBatchUpdate": {
175 | "mutations": [
176 | {
177 | "entityKey": "Eihjb21wb3NpdGUtbGl2ZS1zdHJlYW0tb2ZmbGluZS1lbnRpdHkta2V5IIUEKAE%3D",
178 | "type": "ENTITY_MUTATION_TYPE_DELETE"
179 | },
180 | {
181 | "entityKey": "EgUKA2FiYyD2ASgB",
182 | "type": "ENTITY_MUTATION_TYPE_REPLACE",
183 | "payload": {
184 | "offlineabilityEntity": {
185 | "key": "EgUKA2FiYyD2ASgB",
186 | "addToOfflineButtonState": "ADD_TO_OFFLINE_BUTTON_STATE_UNKNOWN"
187 | }
188 | }
189 | }
190 | ],
191 | "timestamp": {
192 | "seconds": "1749654982",
193 | "nanos": 715113710
194 | }
195 | }
196 | }
197 | }
198 |
--------------------------------------------------------------------------------
/youtube_transcript_api/test/assets/youtube_unplayable.innertube.json.static:
--------------------------------------------------------------------------------
1 | {
2 | "responseContext": {
3 | "visitorData": "Cgs3NmJkd2VWU1N2USj4uaLCBjIKCgJTQRIEGgAgJzoMCAEgkoPMhYCfp6RoWJfwuc_yqZ2rVQ%3D%3D",
4 | "serviceTrackingParams": [
5 | {
6 | "service": "GFEEDBACK",
7 | "params": [
8 | {
9 | "key": "is_viewed_live",
10 | "value": "False"
11 | },
12 | {
13 | "key": "ipcc",
14 | "value": "0"
15 | },
16 | {
17 | "key": "is_alc_surface",
18 | "value": "false"
19 | },
20 | {
21 | "key": "logged_in",
22 | "value": "0"
23 | },
24 | {
25 | "key": "e",
26 | "value": "24004644,24077241,24078649,24104894,24143331,24166867,24181174,24230811,24232551,24241378,24290153,24397985,24513381,24522874,24556101,24585737,39325413,39328442,39328647,51010008,51020570,51025415,51037346,51037353,51054999,51067700,51068313,51080128,51086511,51095478,51115184,51129105,51132535,51137671,51141472,51152050,51175149,51178320,51178333,51178342,51178355,51179435,51179748,51183909,51217334,51227037,51237842,51242448,51248777,51256074,51272458,51295372,51303432,51306453,51311031,51311036,51313109,51313767,51314496,51324733,51326139,51330753,51341228,51346985,51349914,51353393,51354083,51354114,51354567,51356621,51359177,51361830,51362071,51366123,51366423,51366620,51367487,51372971,51375205,51375719,51386541,51388661,51394776,51394779,51397332,51402689,51404808,51404810,51405647,51407634,51417450,51417473,51417480,51417497,51417508,51417523,51420458,51421832,51427573,51428417,51428624,51429106,51430311,51432294,51432529,51432560,51433499,51435249,51435805,51435845,51435875,51435884,51435893,51435905,51435912,51435918,51436950,51437205,51439763,51439874,51440725,51441100,51441710,51442501,51443707,51444218,51447191,51448332,51452420,51452479,51452495,51453239,51456413,51456421,51456628,51458927,51459425,51461268,51462839,51463532,51463930,51465523,51465804,51465955,51466698,51466900,51467076,51467525,51468320,51469820,51471138,51471685,51471785,51472877,51473079,51473810,51475247,51475592,51475686,51475960,51476590,51477496,51477506,51477582,51477845,51478690,51478931,51479232,51479706,51479906,51480511,51481240,51483631,51483888,51484222,51484412,51484746,51484750,51485249,51485417,51485661,51486018,51486232,51486471,51488577,51489047,51489149,51489197,51490157,51490995,51491436,51492251,51492548,51495585,51495706,51495859,51496968,51497133,51498591,51499562,51500337,51500785,51503024,51504828,51505739,51506681,51507237,51508242,51508738,51508979,51509314,51509613,51509678,51510317,51510817,51511950,51512707,51512805,51512852,51514264"
27 | },
28 | {
29 | "key": "visitor_data",
30 | "value": "Cgs3NmJkd2VWU1N2USj4uaLCBjIKCgJTQRIEGgAgJzoMCAEgkoPMhYCfp6Ro"
31 | }
32 | ]
33 | },
34 | {
35 | "service": "CSI",
36 | "params": [
37 | {
38 | "key": "c",
39 | "value": "ANDROID"
40 | },
41 | {
42 | "key": "cver",
43 | "value": "20.10.38"
44 | },
45 | {
46 | "key": "yt_li",
47 | "value": "0"
48 | },
49 | {
50 | "key": "GetPlayer_rid",
51 | "value": "0xbc62793ea45e2d9b"
52 | }
53 | ]
54 | },
55 | {
56 | "service": "GUIDED_HELP",
57 | "params": [
58 | {
59 | "key": "logged_in",
60 | "value": "0"
61 | }
62 | ]
63 | },
64 | {
65 | "service": "ECATCHER",
66 | "params": [
67 | {
68 | "key": "client.version",
69 | "value": "20.10"
70 | },
71 | {
72 | "key": "client.name",
73 | "value": "ANDROID"
74 | }
75 | ]
76 | },
77 | {
78 | "service": "LISTNR",
79 | "params": [
80 | {
81 | "key": "e",
82 | "value": "51237842,51484222,51010008,51459425,51490157,51469820,51507237,51428417,51272458,51435249,51484746,51500337,51491436,51485417,51067700,51295372,51461795,51256074,24195012,51314496,51420458,51453239,51510365,51192010,24250570,24232551,51475592,51485249,51132535,51324733,51179435,51465955,51508738,51354083,24286257,51432294,51432560,51428624,51512707,24181174,51509314,51500785,51447191,51080128,51443707,51458927,51025415,51492251,51463930,51486232,51495859,51095478,51372971,51497133,51270362,24024517,24181216,39328442,51313109,51248777,51366620,51495706,51508979,51152050,51129105,51402689,51404810,51141472,51436950,24522874,51366423,51509613,51397332,51510817,51462839,51498591,24220751,51486471,51456628,51189308,51489047,24104894,24166867,51504828,24585737,51388661,51478931,51442501,51466900,51472877,51488577,51137671,51461268,51217334,51353393,24513381,51020570,51086511,51439874,51306453,51456413,51349914,51387900,51430311,39328647,51202133,51242448,51441100,51375205,51495585,51421832,24143331,51354114,51469823,51439763,51477845,51313767,24230811,51429106,51179748,51467525,39325413,51054999,51471138,51461791,51303432,51466698,24290153,51475960,51404808,51483631,24397985,51489197,51484412,51375719,24033252,51452420,51486018,24556101,51175149,51467076,51506681,24254870,51483888"
83 | }
84 | ]
85 | }
86 | ],
87 | "maxAgeSeconds": 0,
88 | "rolloutToken": "CNrZvdmasunZkgEQ3K6o6d_njQMY3a6o6d_njQM%3D"
89 | },
90 | "playabilityStatus": {
91 | "status": "CUSTOM",
92 | "reason": "Custom Reason",
93 | "errorScreen": {
94 | "playerErrorMessageRenderer": {
95 | "subreason": {
96 | "runs": [
97 | {
98 | "text": "Sub Reason 1"
99 | },
100 | {
101 | "text": "Sub Reason 2",
102 | "navigationEndpoint": {
103 | "clickTrackingParams": "CAAQu2kiEwiZrKjp3-eNAxXimsIBHTHfKdc=",
104 | "urlEndpoint": {
105 | "url": "https://support.google.com/youtube/answer/3037019#zippy=%2Ccheck-that-youre-signed-into-youtube"
106 | }
107 | }
108 | }
109 | ]
110 | },
111 | "reason": {
112 | "runs": [
113 | {
114 | "text": "Sign in to confirm you’re not a bot"
115 | }
116 | ]
117 | },
118 | "proceedButton": {
119 | "buttonRenderer": {
120 | "style": "STYLE_PRIMARY",
121 | "size": "SIZE_DEFAULT",
122 | "isDisabled": false,
123 | "text": {
124 | "simpleText": "Sign in"
125 | },
126 | "navigationEndpoint": {
127 | "clickTrackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX",
128 | "signInEndpoint": {
129 | "nextEndpoint": {
130 | "clickTrackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX",
131 | "urlEndpoint": {
132 | "url": ""
133 | }
134 | }
135 | }
136 | },
137 | "trackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX"
138 | }
139 | },
140 | "thumbnail": {
141 | "thumbnails": [
142 | {
143 | "url": "//s.ytimg.com/yts/img/meh7-vflGevej7.png",
144 | "width": 140,
145 | "height": 100
146 | }
147 | ]
148 | },
149 | "icon": {
150 | "iconType": "ERROR_OUTLINE"
151 | }
152 | }
153 | },
154 | "skip": {
155 | "playabilityErrorSkipConfig": {
156 | "skipOnPlayabilityError": false
157 | }
158 | },
159 | "contextParams": "Q0FFU0FnZ0M="
160 | },
161 | "trackingParams": "CAAQu2kiEwiZrKjp3-eNAxXimsIBHTHfKdc=",
162 | "playerSettingsMenuData": {
163 | "loggingDirectives": {
164 | "trackingParams": "CAEQtc4GIhMImayo6d_njQMV4prCAR0x3ynX",
165 | "visibility": {
166 | "types": "12"
167 | }
168 | }
169 | },
170 | "adBreakHeartbeatParams": "Q0FBJTNE",
171 | "frameworkUpdates": {
172 | "entityBatchUpdate": {
173 | "mutations": [
174 | {
175 | "entityKey": "Eihjb21wb3NpdGUtbGl2ZS1zdHJlYW0tb2ZmbGluZS1lbnRpdHkta2V5IIUEKAE%3D",
176 | "type": "ENTITY_MUTATION_TYPE_DELETE"
177 | },
178 | {
179 | "entityKey": "Eg0KC3d1dnd6SkY0eTdvIPYBKAE%3D",
180 | "type": "ENTITY_MUTATION_TYPE_REPLACE",
181 | "payload": {
182 | "offlineabilityEntity": {
183 | "key": "Eg0KC3d1dnd6SkY0eTdvIPYBKAE%3D",
184 | "addToOfflineButtonState": "ADD_TO_OFFLINE_BUTTON_STATE_UNKNOWN"
185 | }
186 | }
187 | }
188 | ],
189 | "timestamp": {
190 | "seconds": "1749589240",
191 | "nanos": 287157676
192 | }
193 | }
194 | }
195 | }
196 |
--------------------------------------------------------------------------------
/youtube_transcript_api/test/assets/youtube_request_blocked.innertube.json.static:
--------------------------------------------------------------------------------
1 | {
2 | "responseContext": {
3 | "visitorData": "Cgs3NmJkd2VWU1N2USj4uaLCBjIKCgJTQRIEGgAgJzoMCAEgkoPMhYCfp6RoWJfwuc_yqZ2rVQ%3D%3D",
4 | "serviceTrackingParams": [
5 | {
6 | "service": "GFEEDBACK",
7 | "params": [
8 | {
9 | "key": "is_viewed_live",
10 | "value": "False"
11 | },
12 | {
13 | "key": "ipcc",
14 | "value": "0"
15 | },
16 | {
17 | "key": "is_alc_surface",
18 | "value": "false"
19 | },
20 | {
21 | "key": "logged_in",
22 | "value": "0"
23 | },
24 | {
25 | "key": "e",
26 | "value": "24004644,24077241,24078649,24104894,24143331,24166867,24181174,24230811,24232551,24241378,24290153,24397985,24513381,24522874,24556101,24585737,39325413,39328442,39328647,51010008,51020570,51025415,51037346,51037353,51054999,51067700,51068313,51080128,51086511,51095478,51115184,51129105,51132535,51137671,51141472,51152050,51175149,51178320,51178333,51178342,51178355,51179435,51179748,51183909,51217334,51227037,51237842,51242448,51248777,51256074,51272458,51295372,51303432,51306453,51311031,51311036,51313109,51313767,51314496,51324733,51326139,51330753,51341228,51346985,51349914,51353393,51354083,51354114,51354567,51356621,51359177,51361830,51362071,51366123,51366423,51366620,51367487,51372971,51375205,51375719,51386541,51388661,51394776,51394779,51397332,51402689,51404808,51404810,51405647,51407634,51417450,51417473,51417480,51417497,51417508,51417523,51420458,51421832,51427573,51428417,51428624,51429106,51430311,51432294,51432529,51432560,51433499,51435249,51435805,51435845,51435875,51435884,51435893,51435905,51435912,51435918,51436950,51437205,51439763,51439874,51440725,51441100,51441710,51442501,51443707,51444218,51447191,51448332,51452420,51452479,51452495,51453239,51456413,51456421,51456628,51458927,51459425,51461268,51462839,51463532,51463930,51465523,51465804,51465955,51466698,51466900,51467076,51467525,51468320,51469820,51471138,51471685,51471785,51472877,51473079,51473810,51475247,51475592,51475686,51475960,51476590,51477496,51477506,51477582,51477845,51478690,51478931,51479232,51479706,51479906,51480511,51481240,51483631,51483888,51484222,51484412,51484746,51484750,51485249,51485417,51485661,51486018,51486232,51486471,51488577,51489047,51489149,51489197,51490157,51490995,51491436,51492251,51492548,51495585,51495706,51495859,51496968,51497133,51498591,51499562,51500337,51500785,51503024,51504828,51505739,51506681,51507237,51508242,51508738,51508979,51509314,51509613,51509678,51510317,51510817,51511950,51512707,51512805,51512852,51514264"
27 | },
28 | {
29 | "key": "visitor_data",
30 | "value": "Cgs3NmJkd2VWU1N2USj4uaLCBjIKCgJTQRIEGgAgJzoMCAEgkoPMhYCfp6Ro"
31 | }
32 | ]
33 | },
34 | {
35 | "service": "CSI",
36 | "params": [
37 | {
38 | "key": "c",
39 | "value": "ANDROID"
40 | },
41 | {
42 | "key": "cver",
43 | "value": "20.10.38"
44 | },
45 | {
46 | "key": "yt_li",
47 | "value": "0"
48 | },
49 | {
50 | "key": "GetPlayer_rid",
51 | "value": "0xbc62793ea45e2d9b"
52 | }
53 | ]
54 | },
55 | {
56 | "service": "GUIDED_HELP",
57 | "params": [
58 | {
59 | "key": "logged_in",
60 | "value": "0"
61 | }
62 | ]
63 | },
64 | {
65 | "service": "ECATCHER",
66 | "params": [
67 | {
68 | "key": "client.version",
69 | "value": "20.10"
70 | },
71 | {
72 | "key": "client.name",
73 | "value": "ANDROID"
74 | }
75 | ]
76 | },
77 | {
78 | "service": "LISTNR",
79 | "params": [
80 | {
81 | "key": "e",
82 | "value": "51237842,51484222,51010008,51459425,51490157,51469820,51507237,51428417,51272458,51435249,51484746,51500337,51491436,51485417,51067700,51295372,51461795,51256074,24195012,51314496,51420458,51453239,51510365,51192010,24250570,24232551,51475592,51485249,51132535,51324733,51179435,51465955,51508738,51354083,24286257,51432294,51432560,51428624,51512707,24181174,51509314,51500785,51447191,51080128,51443707,51458927,51025415,51492251,51463930,51486232,51495859,51095478,51372971,51497133,51270362,24024517,24181216,39328442,51313109,51248777,51366620,51495706,51508979,51152050,51129105,51402689,51404810,51141472,51436950,24522874,51366423,51509613,51397332,51510817,51462839,51498591,24220751,51486471,51456628,51189308,51489047,24104894,24166867,51504828,24585737,51388661,51478931,51442501,51466900,51472877,51488577,51137671,51461268,51217334,51353393,24513381,51020570,51086511,51439874,51306453,51456413,51349914,51387900,51430311,39328647,51202133,51242448,51441100,51375205,51495585,51421832,24143331,51354114,51469823,51439763,51477845,51313767,24230811,51429106,51179748,51467525,39325413,51054999,51471138,51461791,51303432,51466698,24290153,51475960,51404808,51483631,24397985,51489197,51484412,51375719,24033252,51452420,51486018,24556101,51175149,51467076,51506681,24254870,51483888"
83 | }
84 | ]
85 | }
86 | ],
87 | "maxAgeSeconds": 0,
88 | "rolloutToken": "CNrZvdmasunZkgEQ3K6o6d_njQMY3a6o6d_njQM%3D"
89 | },
90 | "playabilityStatus": {
91 | "status": "LOGIN_REQUIRED",
92 | "reason": "Sign in to confirm you’re not a bot",
93 | "errorScreen": {
94 | "playerErrorMessageRenderer": {
95 | "subreason": {
96 | "runs": [
97 | {
98 | "text": "This helps protect our community. "
99 | },
100 | {
101 | "text": "Learn more",
102 | "navigationEndpoint": {
103 | "clickTrackingParams": "CAAQu2kiEwiZrKjp3-eNAxXimsIBHTHfKdc=",
104 | "urlEndpoint": {
105 | "url": "https://support.google.com/youtube/answer/3037019#zippy=%2Ccheck-that-youre-signed-into-youtube"
106 | }
107 | }
108 | }
109 | ]
110 | },
111 | "reason": {
112 | "runs": [
113 | {
114 | "text": "Sign in to confirm you’re not a bot"
115 | }
116 | ]
117 | },
118 | "proceedButton": {
119 | "buttonRenderer": {
120 | "style": "STYLE_PRIMARY",
121 | "size": "SIZE_DEFAULT",
122 | "isDisabled": false,
123 | "text": {
124 | "simpleText": "Sign in"
125 | },
126 | "navigationEndpoint": {
127 | "clickTrackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX",
128 | "signInEndpoint": {
129 | "nextEndpoint": {
130 | "clickTrackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX",
131 | "urlEndpoint": {
132 | "url": ""
133 | }
134 | }
135 | }
136 | },
137 | "trackingParams": "CAIQptEGIhMImayo6d_njQMV4prCAR0x3ynX"
138 | }
139 | },
140 | "thumbnail": {
141 | "thumbnails": [
142 | {
143 | "url": "//s.ytimg.com/yts/img/meh7-vflGevej7.png",
144 | "width": 140,
145 | "height": 100
146 | }
147 | ]
148 | },
149 | "icon": {
150 | "iconType": "ERROR_OUTLINE"
151 | }
152 | }
153 | },
154 | "skip": {
155 | "playabilityErrorSkipConfig": {
156 | "skipOnPlayabilityError": false
157 | }
158 | },
159 | "contextParams": "Q0FFU0FnZ0M="
160 | },
161 | "trackingParams": "CAAQu2kiEwiZrKjp3-eNAxXimsIBHTHfKdc=",
162 | "playerSettingsMenuData": {
163 | "loggingDirectives": {
164 | "trackingParams": "CAEQtc4GIhMImayo6d_njQMV4prCAR0x3ynX",
165 | "visibility": {
166 | "types": "12"
167 | }
168 | }
169 | },
170 | "adBreakHeartbeatParams": "Q0FBJTNE",
171 | "frameworkUpdates": {
172 | "entityBatchUpdate": {
173 | "mutations": [
174 | {
175 | "entityKey": "Eihjb21wb3NpdGUtbGl2ZS1zdHJlYW0tb2ZmbGluZS1lbnRpdHkta2V5IIUEKAE%3D",
176 | "type": "ENTITY_MUTATION_TYPE_DELETE"
177 | },
178 | {
179 | "entityKey": "Eg0KC3d1dnd6SkY0eTdvIPYBKAE%3D",
180 | "type": "ENTITY_MUTATION_TYPE_REPLACE",
181 | "payload": {
182 | "offlineabilityEntity": {
183 | "key": "Eg0KC3d1dnd6SkY0eTdvIPYBKAE%3D",
184 | "addToOfflineButtonState": "ADD_TO_OFFLINE_BUTTON_STATE_UNKNOWN"
185 | }
186 | }
187 | }
188 | ],
189 | "timestamp": {
190 | "seconds": "1749589240",
191 | "nanos": 287157676
192 | }
193 | }
194 | }
195 | }
196 |
--------------------------------------------------------------------------------
/youtube_transcript_api/test/assets/youtube_consent_page_invalid.html.static:
--------------------------------------------------------------------------------
1 |
83 |
236 |
237 | 84 | Perdón por la interrupción. Hemos recibido un gran número de 85 | solicitudes de tu red. 86 |
87 |88 | Para seguir disfrutando de YouTube, rellena el siguiente formulario. 89 |
90 | 105 | 198 |
199 | ES
206 |
234 |
235 | 
ein Google-Unternehmen
Bevor Sie zu YouTube weitergehen
Google verwendet Cookies und Daten, um Dienste und Werbung zur Verfügung zu stellen, zu verwalten und zu verbessern. Wenn Sie zustimmen, nutzen wir Cookies für diese Zwecke und dazu, Inhalte und Werbung für Sie zu personalisieren, damit Sie z. B. relevantere Google-Suchergebnisse und relevantere Werbung bei YouTube erhalten. Die Personalisierung erfolgt auf Grundlage Ihrer Aktivitäten, beispielsweise Ihrer Google-Suchanfragen und der Videos, die Sie sich bei YouTube ansehen. Wir verwenden diese Daten auch für Analysen und Messungen. Klicken Sie auf „Anpassen“, um sich weitere Optionen anzusehen, oder besuchen Sie g.co/privacytools. Darüber hinaus haben Sie die Möglichkeit, Ihre Browsereinstellungen so zu konfigurieren, dass einige oder alle Cookies blockiert werden.
ein Google-UnternehmenBevor Sie zu YouTube weitergehen
Google verwendet Cookies und Daten, um Dienste und Werbung zur Verfügung zu stellen, zu verwalten und zu verbessern. Wenn Sie zustimmen, nutzen wir Cookies für diese Zwecke und dazu, Inhalte und Werbung für Sie zu personalisieren, damit Sie z. B. relevantere Google-Suchergebnisse und relevantere Werbung bei YouTube erhalten. Die Personalisierung erfolgt auf Grundlage Ihrer Aktivitäten, beispielsweise Ihrer Google-Suchanfragen und der Videos, die Sie sich bei YouTube ansehen. Wir verwenden diese Daten auch für Analysen und Messungen. Klicken Sie auf „Anpassen“, um sich weitere Optionen anzusehen, oder besuchen Sie g.co/privacytools. Darüber hinaus haben Sie die Möglichkeit, Ihre Browsereinstellungen so zu konfigurieren, dass einige oder alle Cookies blockiert werden.
2 | ✨ YouTube Transcript API ✨ 3 |
4 | 5 |
6 |
7 | 
8 |
9 |
10 | 
11 |
12 |
13 | 
14 |
15 |
16 | 
17 |
18 |
19 | 
20 |
21 |
22 | 
23 |
24 |
27 | This is a python API which allows you to retrieve the transcript/subtitles for a given YouTube video. It also works for automatically generated subtitles, supports translating subtitles and it does not require a headless browser, like other selenium based solutions do! 28 |
29 |30 | Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💖 31 |
32 | 33 |
34 |
35 | 
39 | 
47 | 
55 | 
63 |