Vidscraper is a python library which provides a simple API for fetching video data from various web services and sites.
Python Shell


Vidscraper is a library for retrieving information about videos from various sources – video feeds, APIs, page scrapes – combining it, and presenting it in a unified manner, all as efficiently as possible.

Vidscraper comes with built-in support for popular video sites like blip, vimeo, ustream, and youtube, as well support for generic RSS feeds with feedparser.

Quick example

>>> import vidscraper
>>> video = vidscraper.auto_scrape('')
>>> video.title
u"The Magic Roundabout - Ermintrude's Folly"
>>> video.description
u"Ermintrude's been at the poppies again, but it's Dougal who ends up high as a kite!"
>>> video.user
>>> video.guid

Command line

vidscraper also comes with a command line utility allowing you to get video metadata from the command line. The example above could look like this:

$ vidscraper video \
  "description": "Ermintrude's been at the poppies again, but it's Dougal who ends up high as a kite!",
  "fields": [
  "guid": "",
  "title": "The Magic Roundabout - Ermintrude's Folly",
  "url": "",
  "user": "nickhirst999"

Project links

irc:#vidscraper on
build status:build-image



  • requests-oauth 0.4.1+ (for some APIs *cough* Vimeo searching *cough* which require authentication)
  • lxml 2.3.4+ (recommended for BeautifulSoup; assumed parser for test results.)
  • unittest2 0.5.1+ (for tests)
  • mock 0.8.0+ (for tests)
  • tox 1.4.2+ (for tests)