unstale

pypi / youtube-transcript-api

youtube-transcript-api

What changed in youtube-transcript-api 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-23.

4 breaking2 deprecations8 new APIs and options1 tooling1 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.3 on npm

youtube-transcript-api 116 changes

Breaking changes 4

  • Returns a FetchedTranscript object instead of a list of dictionaries; call to_raw_data() to convert to the previous format.

    1.0.0release notes

  • The old static method is deprecated and has no equivalent in the new interface; fetch transcripts individually instead.

    1.0.0release notes

  • Raised when YouTube blocks a request due to a blacklisted IP, replacing the prior TranscriptDisabled error for this case.

    1.0.0release notes

  • Introduces an instance-based API with fetch and list methods, allowing requests to share an HTTP session, cookies, and bandwidth.

    1.0.0release notes

Deprecations 2

  • The old static method is deprecated in favor of YouTubeTranscriptsApi().fetch(video_id).

    1.0.0release notes

  • The old static method is deprecated in favor of YouTubeTranscriptsApi().list(video_id).

    1.0.0release notes

New APIs and options 8

  • Raised when a video is age restricted and requires cookie authentication.

    1.0.0release notes

  • Adds a return object for fetched transcripts, enabling metadata and utility methods.

    1.0.0release notes

  • Adds configuration for generic HTTP, HTTPS, and SOCKS proxies.

    1.0.0release notes

  • The YouTubeTranscriptApi constructor accepts an HTTP session, allowing CA_BUNDLE paths, custom headers, and session sharing across instances.

    1.0.0release notes

  • Converts a FetchedTranscript object to the previously used list-of-dictionaries format.

    1.0.0release notes

  • Raised when a video is unplayable for an unknown reason and includes the error message shown by YouTube's WebPlayer.

    1.0.0release notes

  • Adds Webshare proxy provider integration for setting up rotating residential proxies.

    1.0.0release notes

  • Adds a module containing proxy configuration classes that can be passed to the YouTubeTranscriptApi constructor.

    1.0.0release notes

Tooling 1

Fixes and other changes 1

  • When a proxy username contains the "-rotate" suffix, it is no longer appended twice.

    1.2.4release notes