{"id":13747676,"url":"https://github.com/dewski/itunes","last_synced_at":"2025-05-09T09:30:44.622Z","repository":{"id":1091926,"uuid":"946739","full_name":"dewski/itunes","owner":"dewski","description":"A Ruby wrapper around the iTunes API that lets you search for any sort of data that is available on the iTunes store.  ","archived":true,"fork":false,"pushed_at":"2018-07-10T14:52:36.000Z","size":681,"stargazers_count":122,"open_issues_count":5,"forks_count":29,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-05-11T21:43:26.485Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://github.com/dewski/itunes","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dewski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-09-28T21:29:28.000Z","updated_at":"2023-11-27T05:54:43.000Z","dependencies_parsed_at":"2022-07-17T12:16:13.967Z","dependency_job_id":null,"html_url":"https://github.com/dewski/itunes","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Fitunes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Fitunes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Fitunes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewski%2Fitunes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dewski","download_url":"https://codeload.github.com/dewski/itunes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224849358,"owners_count":17380105,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T06:01:37.336Z","updated_at":"2024-11-15T21:30:48.252Z","avatar_url":"https://github.com/dewski.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"iTunes [![Build Status](https://secure.travis-ci.org/dewski/itunes.png)](http://travis-ci.org/dewski/itunes)\n======\n\nA Ruby wrapper around the iTunes API that lets you search for any sort of data that is available on the iTunes store.\n\nExample Response\n----------------\n\n```json\n{\n  \"artist_id\" : 954266,\n  \"artist_name\" : \"Green Day\",\n  \"artist_view_url\" : \"http://itunes.apple.com/us/artist/green-day/id954266?uo=4\",\n  \"artwork_url100\" : \"http://a1.phobos.apple.com/us/r1000/049/Features/1e/17/05/dj.rpihtiig.100x100-75.jpg\",\n  \"artwork_url30\" : \"http://a1.phobos.apple.com/us/r1000/049/Features/1e/17/05/dj.rpihtiig.30x30-50.jpg\",\n  \"artwork_url60\" : \"http://a1.phobos.apple.com/us/r1000/049/Features/1e/17/05/dj.rpihtiig.60x60-50.jpg\",\n  \"collection_censored_name\" : \"Dookie\",\n  \"collection_explicitness\" : \"explicit\",\n  \"collection_id\" : 5132583,\n  \"collection_name\" : \"Dookie\",\n  \"collection_price\" : 9.99,\n  \"collection_view_url\" : \"http://itunes.apple.com/us/album/she/id5132583?i=5132563\u0026uo=4\",\n  \"content_advisory_rating\" : null,\n  \"country\" : \"USA\",\n  \"currency\" : \"USD\",\n  \"disc_count\" : 1,\n  \"disc_number\" : 1,\n  \"kind\" : \"song\",\n  \"preview_url\" : \"http://a1.phobos.apple.com/us/r1000/027/Music/0e/86/7a/mzm.wchstext.aac.p.m4a\",\n  \"primary_genre_name\" : \"Alternative\",\n  \"release_date\" : \"2003-04-22 07:00:00 Etc/GMT\",\n  \"track_censored_name\" : \"She\",\n  \"track_count\" : 15,\n  \"track_explicitness\" : \"notExplicit\",\n  \"track_id\" : 5132563,\n  \"track_name\" : \"She\",\n  \"track_number\" : 8,\n  \"track_price\" : 1.29,\n  \"track_time_millis\" : 134293,\n  \"track_view_url\" : \"http://itunes.apple.com/us/album/she/id5132583?i=5132563\u0026uo=4\",\n  \"wrapper_type\" : \"track\"\n}\n```\n\nAvailable Methods\n-----------------\n\n* movie\n* podcast\n* music\n* music_video\n* audiobook\n* short_film\n* tv_show\n* ebook\n* software\n* all\n\nUsing the iTunes gem\n--------------------\n\n    require 'itunes'\n\n    \u003e\u003e itunes = ITunes::Client.new\n    \u003e\u003e songs = itunes.music('green day she')\n    =\u003e \u003c#Hashie::Rash result_count=15 results=[...]\u003e\n    \u003e\u003e songs.results.each do |song|\n    \u003e\u003e   puts \"#{song.track_name} - #{song.artist_name} (#{song.collection_name})\"\n    \u003e\u003e end\n    =\u003e She - Green Day (Dookie)\n    =\u003e She - Green Day (Dookie)\n    =\u003e She - Green Day (Dookie)\n    =\u003e She - Green Day (Dookie)\n    =\u003e She - Green Day (Dookie)\n\nSearch directly from the class\n\n    \u003e\u003e iron_man = ITunes.movie('iron man 2')\n    =\u003e \u003c#Hashie::Rash result_count=1 results=[...]\u003e\n\nLimit the results:\n\n    \u003e\u003e foo_fighters = ITunes.music('foo fighters everlong', :limit =\u003e 1)\n    =\u003e \u003c#Hashie::Rash result_count=1 results=[\u003c#Hashie::Rash ...\u003e]\u003e\n\nWhat is Hashie::Rash?\n\nIf you are familiar with Hashie, Rash is very similar to a Mash.  The primary difference is that Rash gives us ruby-friendly keys so instead of artistId, Rash converts that to artist_id.\n\nCopyright\n---------\n\nCopyright © 2011 Garrett Bjerkhoel, Steve Agalloco. See [MIT-LICENSE](http://github.com/dewski/itunes/blob/master/MIT-LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewski%2Fitunes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdewski%2Fitunes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewski%2Fitunes/lists"}