Skip to main content

Python Client for Google's Private InnerTube API. Works with Youtube, YouTube Music and more!

Project description

innertube

Python Client for Google's Private InnerTube API. Works with YouTube, YouTube Music, YouTube Kids, YouTube Studio and more!

About

This library handles low-level interactions with the underlying InnerTube API used by each of the YouTube services.

Here are a few articles available online relating to the InnerTube API:

Installation

innertube uses Poetry under the hood and can easily be installed from source or from PyPI using pip.

Latest Release

pip install innertube

Bleeding Edge

pip install git+https://github.com/tombulled/innertube@develop

Usage

>>> import innertube
>>>
>>> # Construct a client
>>> client = innertube.InnerTube("WEB")
>>>
>>> # Get some data!
>>> data = client.search(query="foo fighters")
>>>
>>> # Power user? No problem, dispatch requests yourself
>>> data = client("browse", body={"browseId": "FEwhat_to_watch"})
>>>
>>> # The core endpoints are implemented, so the above is equivalent to:
>>> data = client.browse("FEwhat_to_watch")

Comparison with the YouTube Data API

The InnerTube API provides access to data you can't get from the Data API, however it comes at somewhat of a cost (explained below).

This Library YouTube Data API
Google account required No Yes
Request limit No Yes
Clean data No Yes

The InnerTube API is used by a variety of YouTube services and is not designed for consumption by users. Therefore, the data returned by the InnerTube API will need to be parsed and sanitised to extract data of interest.

Endpoints

Currently only the following core, unauthenticated endpoints are implemented:

YouTube YouTubeMusic YouTubeKids YouTubeStudio
config
browse
player
next
search
guide
get_transcript
music/get_search_suggestions
music/get_queue

Authentication

The InnerTube API uses OAuth2, however this has not yet been implemented, therefore this library currently only provides unauthenticated API access.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

innertube-2.1.16.tar.gz (10.5 kB view details)

Uploaded Source

Built Distribution

innertube-2.1.16-py3-none-any.whl (11.8 kB view details)

Uploaded Python 3

File details

Details for the file innertube-2.1.16.tar.gz.

File metadata

  • Download URL: innertube-2.1.16.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.10.12 Linux/5.15.0-105-generic

File hashes

Hashes for innertube-2.1.16.tar.gz
Algorithm Hash digest
SHA256 d8d3fba018ae175607c9b9fd051f9ac64aeddff6acfa74e498236f7777c911c2
MD5 8bd10c4c01b459e9141ba926fbf0f415
BLAKE2b-256 846572d29b66b30c82b79ba52f7aadcdf7940afe49d0a3887fa156b55101d5fd

See more details on using hashes here.

File details

Details for the file innertube-2.1.16-py3-none-any.whl.

File metadata

  • Download URL: innertube-2.1.16-py3-none-any.whl
  • Upload date:
  • Size: 11.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.10.12 Linux/5.15.0-105-generic

File hashes

Hashes for innertube-2.1.16-py3-none-any.whl
Algorithm Hash digest
SHA256 5a009eca80f3f588ba840d36fb0de388d8734d4a2d28545018b2989abeb5a57a
MD5 256e9b0f5b2f316434f1606bdaedd9bc
BLAKE2b-256 0bc89babe96d05d94eddc87b0f981937bcdb710485a0526c39c6bb442053ffdb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page