Skip to main content

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.

Source Distribution

simple-youtube-api-0.2.8.tar.gz (18.5 kB view hashes)

Uploaded source

Built Distribution

simple_youtube_api-0.2.8-py3-none-any.whl (24.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page