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 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.Video import Video

channel = Channel()
channel.login("client_secret.json", "")

video = LocalVideo(file_path="test_vid.mp4", title="This is a title")
video.set_description("This is a description")
video.set_tags(["this", "tag"])



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:

$ (sudo) python install

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

$ (sudo) 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
  6. Select that you will call API from “Web Server”
  7. Select “Public Data” if you want to not get private data and “User Data” if you do
  8. Download or copy your API key from the Credentials tab


Running Tests

Run the python command

python pytest


  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.2
Filename, size File type Python version Upload date Hashes
Filename, size simple_youtube_api-0.2.2-py3-none-any.whl (19.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size simple-youtube-api-0.2.2.tar.gz (14.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page