You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit bd59b1a
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ Covered so far: every error class in [youtube-transcript-api](https://github.com
34
34
35
35
The most common failures (`IpBlocked`, `RequestBlocked`) say something about the network the request came from, not about the video. In rough order of effort:
36
36
37
-
1. Wait and retry later with a back-off instead of a tight loop. Blocks on one IP often lift after some hours.
37
+
1. Wait and retry later with a back-off instead of a tight loop. How long a block lasts varies: on one home IP we saw a block lift after roughly 25 minutes and return soon after requests resumed at about ten a minute, so slow down well below that.
38
38
2. Run from a different network. A home or office connection is treated differently from a cloud server.
39
39
3. Send requests through a proxy provider. [youtube-transcript-api supports proxy configuration](https://github.com/jdepoix/youtube-transcript-api#working-around-ip-bans-requestblocked-or-ipblocked-exception).
40
40
4. Cache what you fetch and fetch each video once.
Copy file name to clipboardExpand all lines: data/errors.yaml
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ errors:
18
18
kind: environment
19
19
text: "No fixed video reproduces it. It depends on the network the request comes from: send enough requests from one IP, or run from a datacenter IP."
20
20
actions:
21
-
- "Stop and wait. Blocks on a single IP often lift after some hours, so back off instead of retrying in a loop."
21
+
- "Stop and wait. How long a block lasts varies. On one home IP (2026-10-17) it lifted after roughly 25 minutes and came back soon after requests resumed at about ten a minute, so back off and slow down instead of retrying in a loop."
22
22
- "Run the code from a different network, for example a home or office connection instead of a cloud server."
23
23
- "Send the requests through a proxy provider. The library supports proxy configuration."
24
24
- "Cache what you already fetched and fetch each video once."
Copy file name to clipboardExpand all lines: errors/ipblocked.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ No fixed video reproduces it. It depends on the network the request comes from:
22
22
23
23
## What to do
24
24
25
-
- Stop and wait. Blocks on a single IP often lift after some hours, so back off instead of retrying in a loop.
25
+
- Stop and wait. How long a block lasts varies. On one home IP (2026-10-17) it lifted after roughly 25 minutes and came back soon after requests resumed at about ten a minute, so back off and slow down instead of retrying in a loop.
26
26
- Run the code from a different network, for example a home or office connection instead of a cloud server.
27
27
- Send the requests through a proxy provider. The library supports proxy configuration.
28
28
- Cache what you already fetched and fetch each video once.
0 commit comments