Skip to content
Search youtube via this simple ruby api
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
spec
.travis.yml
Gemfile
Gemfile.lock
Rakefile
Readme.md
youtube_search.gemspec

Readme.md

Search youtube via this simple ruby api

  • simple
  • no dependencies

Install

gem install youtube_search

Usage

YoutubeSearch.search('boat').first
{
  "title"=>"Killer Whale Imitates Boat Motor",
  "published"=>"2011-09-29T15:30:43.000Z",
  "id"=>"http://gdata.youtube.com/feeds/api/videos/0b2U5r7Jwkc",
  "video_id"=>"0b2U5r7Jwkc",
  "content"=>"Top YouTube Videos on ...",
  "updated"=>"2011-10-13T20:20:54.000Z",
  "raw" => <REXML::Element ... >,
  "embeddable" => true,
  ...
}

or raw json with format: 'json'

page / per_page are supported

YoutubeSearch.search('cats', :page => 10, :per_page => 4).first

and standard youtube options

YoutubeSearch.search('cats', 'time' => 'this_week', 'orderby' => 'viewCount').first

I can haz iframe:

# DISCLAIMER this iframe may steal 4 minutes of your life ;)
id = YoutubeSearch.search('lolcats').first['video_id']
%{<iframe src="http://www.youtube.com/embed/#{id}" width=640 height=480 frameborder=0></iframe>}

Searching playlists

YoutubeSearch.search_playlists('cats').first

Retrieve videos by playlist ID

videos = YoutubeSearch.playlist_videos('5F23DAF4BFE3D14C')

TODO

  • more detailed xml parsing (you can fetch everything via 'raw', but more defaults would be nice)
  • parse dates into ruby objects

Author

Contributors

Michael Grosser
michael@grosser.it
License: MIT Build Status

Something went wrong with that request. Please try again.