youtube_search's Introduction

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
[email protected]
License: MIT

youtube_search's People

Contributors

Stargazers

Watchers

youtube_search's Issues

Api work broken

Youtube move API to v3. So gem not work.

YoutubeSearch.search('lolcats').first['video_id']
OpenURI::HTTPError: 410 Gone

API version is deprecated

The API version in use has been deprecated as of April the 20th. https://support.google.com/youtube/answer/6098135?hl=en

Filtering by author doesn't work

I think it is because the url syntax was changed.. it seems that it should be something like this:

http://gdata.youtube.com/feeds/api/videos?v=2&alt=jsonc&author=HuskyStarcraft

Obtaining all results for a term

Hi, is there a way to obtain all results for a term? The results seem limited.

Eg: YoutubeSearch.search('cat', 'time' => 'all_time', 'orderby' => 'viewCount', :page => 26, :per_page => 4)

This returns about 100 results (26 pages) divided into pages. Is there a way to get all the results available? Thanks.

-Thomas

Obtaining a playlist

Hi grosser,

I was wondering if I could use your gem to fetch videos from a certain user and playlist.

Reading the Youtube API docs here http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Playlists I can see this is posible through the API. The URL for retrieving videos from a playlist looks like

https://gdata.youtube.com/feeds/api/playlists/8BCDD04DE8F771B2?v=2

Would it be posible with youtube_searchor should I write it myself? Would you be interested in such a pull request if so?

Regards

Recommend Projects