Project

nashville

0.06
Repository is archived
No commit activity in last 3 years
No release in over 3 years
iTunes Store API Client
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0

Runtime

 Project Readme

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.