Home

Awesome

Nashville

Note: This project is no longer being maintained.

Nashville is a wrapper and command line interface for querying the iTunes Store API.

Nashville is named after the eponymous Capital of Country Music (and Tennesee), home of the Grand 'Ole Opry and the Country Music Hall of Fame and Museum.

Installation

$ gem install nashville

Usage

require 'nashville'

Nashville::Movie.search(director: "Wes Anderson")

Nashville::Music::Artist.search(artist: "Miles Davis", limit: 5)

For more information about parameters and general usage, check out Apple's documentation for the iTunes Affiliate Search API.

Command Line Interface

Nashville also comes with the its binary, which allows you to query the iTunes Store from the command line:

$ its search --help

Usage: its search QUERY

  Examples:

    # search
    its search "Jamiroquai"

  Options:
    -m, --media MEDIA    The media type to search for
    -e, --entity ENTITY  The type of results to be returned, relative to the specified media type.
    -a, --attribute ATTRIBUTE The attribute to be searched for in the stores, relative to the specified media type.

    --limit LIMIT        The maximum number of results to return.
    --language LANGUAGE  The language, English or Japanese, to use when returning search results.
    -p, --secret SECRET  Use a shared secret for auto-renewable subscription receipts
    -X, --[no-]explicit  Include explicit content in search results.


$ its search "Blue in Green" --media music --entity song

50 Results

+------------------------+---------------------------------------------------------------------------------+
|                                                 Result 1                                                 |
+------------------------+---------------------------------------------------------------------------------+
| artistId               | 44984                                                                           |
| artistName             | Miles Davis                                                                     |
| artistViewUrl          | https://itunes.apple.com/us/artist/miles-davis/id44984?uo=4                     |
| artworkUrl100          | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.100x100-75.jpg        |
| artworkUrl30           | http://a3.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.30x30-50.jpg          |
| artworkUrl60           | http://a2.mzstatic.com/us/r30/Music/75/d7/9e/mzi.tugmofjx.60x60-50.jpg          |
| collectionCensoredName | Kind of Blue                                                                    |
| collectionExplicitness | notExplicit                                                                     |
| collectionId           | 162322551                                                                       |
| collectionName         | Kind of Blue                                                                    |
| collectionPrice        | 9.99                                                                            |
| collectionViewUrl      | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872&uo=4    |
| country                | USA                                                                             |
| currency               | USD                                                                             |
| discCount              | 1                                                                               |
| discNumber             | 1                                                                               |
| kind                   | song                                                                            |
| previewUrl             | http://a456.phobos.apple.com/us/r1000/090/Music/ca/55/73/mzm.yslzuywm.aac.p.m4a |
| primaryGenreName       | Jazz                                                                            |
| radioStationUrl        | https://itunes.apple.com/us/station/idra.162322872                              |
| releaseDate            | 1997-03-04T08:00:00Z                                                            |
| trackCensoredName      | Blue In Green                                                                   |
| trackCount             | 6                                                                               |
| trackExplicitness      | notExplicit                                                                     |
| trackId                | 162322872                                                                       |
| trackName              | Blue In Green                                                                   |
| trackNumber            | 3                                                                               |
| trackPrice             | 0.99                                                                            |
| trackTimeMillis        | 337560                                                                          |
| trackViewUrl           | https://itunes.apple.com/us/album/blue-in-green/id162322551?i=162322872&uo=4    |
| wrapperType            | track                                                                           |
+------------------------+---------------------------------------------------------------------------------+

...

License

Nashville is available under the MIT license. See the LICENSE file for more info.