Skip to content

Commit bd59b1a

Browse files
Correct block duration wording to match what was observed
1 parent 30d813a commit bd59b1a

3 files changed

Lines changed: 3 additions & 3 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Covered so far: every error class in [youtube-transcript-api](https://github.com
3434

3535
The most common failures (`IpBlocked`, `RequestBlocked`) say something about the network the request came from, not about the video. In rough order of effort:
3636

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.
3838
2. Run from a different network. A home or office connection is treated differently from a cloud server.
3939
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).
4040
4. Cache what you fetch and fetch each video once.

‎data/errors.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ errors:
1818
kind: environment
1919
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."
2020
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."
2222
- "Run the code from a different network, for example a home or office connection instead of a cloud server."
2323
- "Send the requests through a proxy provider. The library supports proxy configuration."
2424
- "Cache what you already fetched and fetch each video once."

‎errors/ipblocked.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ No fixed video reproduces it. It depends on the network the request comes from:
2222

2323
## What to do
2424

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.
2626
- Run the code from a different network, for example a home or office connection instead of a cloud server.
2727
- Send the requests through a proxy provider. The library supports proxy configuration.
2828
- Cache what you already fetched and fetch each video once.

0 commit comments

Comments
 (0)