Field notes

Things we measured while building this API, written down because we could not find them written down anywhere else. Numbers here come from real runs, and the method is named so you can repeat them.

18 August 20269 min read

How to Get YouTube Captions for Videos You Don't Own

The official Data API has a captions.download endpoint, and it will not help you: it requires OAuth as the video's owner and returns 403 for anyone else's. Here is what actually works, why your server gets IP-blocked the moment you self-host it, and the curl test that will lie to you while you debug.

read →
18 August 20268 min read

Translating 300 Subtitle Segments in 7 Seconds Instead of 35

One chat-completions call for a whole transcript took 35 seconds — past the timeout of most HTTP clients. Splitting it into concurrent chunks brought it to 6.6, but smaller chunks started dropping lines. The measurements, the trade-off, and why the billing constant must not share a value with the chunk size.

read →