Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/grosser/youtube_search

Search youtube via this simple ruby api
https://github.com/grosser/youtube_search

Last synced: 11 days ago
JSON representation

Search youtube via this simple ruby api

Awesome Lists containing this project

README

        

Search youtube via this simple ruby api

- simple
- no dependencies

Install
=======

```Bash
gem install youtube_search
```

Usage
=====

```Ruby
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" => ,
"embeddable" => true,
...
}
```

or raw json with `format: 'json'`

page / per_page are supported

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

and [standard youtube options](http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Standard_parameters)

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

### I can haz iframe:

```Ruby
# DISCLAIMER this iframe may steal 4 minutes of your life ;)
id = YoutubeSearch.search('lolcats').first['video_id']
%{}
```

### Searching playlists

```Ruby
YoutubeSearch.search_playlists('cats').first
```

### Retrieve videos by playlist ID

```Ruby
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](https://github.com/grosser/youtube_search/contributors)
- [David Gil](https://qoolife.com)
- [Jim Jones](https://github.com/aantix)
- [Sławek](https://github.com/sbogutyn)
- [Alex Weidmann](https://github.com/effektz)
- [David Gil](https://github.com/dgilperez)

[Michael Grosser](http://grosser.it)

[email protected]

License: MIT
[![Build Status](https://travis-ci.org/grosser/youtube_search.png)](https://travis-ci.org/grosser/youtube_search)