Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

A python YouTube API wrapper

Project description

Simple YouTube API page on the Python Package Index Build status on travis Coverage on coveralls

Simple Youtube API(full documentation) is a Youtube API wrapper for python, making it easier to search and upload your videos.


In this example we log in into a YouTube channel, set the appropriate variables for a video and upload the video to the YouTube channel that we logged into:

from simple_youtube_api.Channel import Channel
from simple_youtube_api.LocalVideo import LocalVideo

# loggin into the channel
channel = Channel()
channel.login("client_secret.json", "")

# setting up the video that is going to be uploaded
video = LocalVideo(file_path="test_vid.mp4")

# setting snippet
video.set_title("My Title")
video.set_description("This is a description")
video.set_tags(["this", "tag"])

# setting status

# setting thumbnail

# uploading video and printing the results
video = channel.upload_video(video)

# liking video


Simple YouTube API needs API keys from Google in order to be able to make queries to YouTube.

Installation by hand: you can download the source files from PyPi or Github:

python install

Installation with pip: make sure that you have pip installed, type this in a terminal:

pip install simple-youtube-api

Generating YouTube API Keys

  1. Log into
  2. Create a new Project
  3. Search for “YouTube Data API V3”
  4. Click Credentials
  5. Click Create Credentials

For user data: 5. Select OAuth Client ID 6. Select that you will call API from “Web Server” 7. Download or copy your API key from the Credentials tab

For non-user data 5. Select API Key 6. Paste the key into a file

Running Tests

Run the python command

python test


  1. Fork the repository from Github
  2. Clone your fork
git clone
  1. Add the main repository as a remote
git remote add upstream
  1. Create a pull request and follow the guidelines


jonnekaunisto (owner)

Project details

Download files

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

Files for simple-youtube-api, version 0.2.8
Filename, size File type Python version Upload date Hashes
Filename, size simple_youtube_api-0.2.8-py3-none-any.whl (24.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size simple-youtube-api-0.2.8.tar.gz (18.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page