iTunes APIの使い方まとめ

iTunes APIの使い方まとめ

App Storeで販売されている、音楽や本、映画、アプリなどといった商品データを検索、取得することができる「iTunes API」の使い方について、まとめています。

リクエスト方法

この章では、iTunesの検索用APIの仕様と使い方について、説明します。なお、リクエストするにあたって、開発者登録や、APIキーの取得などといった作業は必要ありません。

エンドポイント

下記のURLアドレスに、GETメソッドでリクエストを送ります。

GET https://itunes.apple.com/search

パラメータ

リクエストの際に指定できる主なパラメータは下記の通りです。

term
検索キーワード。PHPだったらrawurlencode()、JavaScriptならencodeURIComponent()などで、URLエンコードをする必要がある。
country
検索対象となる国の2桁コード(ISO 3166-1)を指定する。日本の場合はjp、英語の場合はen
media
取得対象の商品の種類を、専用のIDで指定する。
movie … 映画。
podcast … ポッドキャスト。
music … 音楽。
musicVideo … ミュージックビデオ。
audiobook … オーディオブック。
shortFilm … ショートフィルム。
tvShow … TV番組。
software … アプリケーション。
ebook … 電子書籍。
all … すべて。
entity
mediaで指定した、取得対象の商品の種類の中で、さらに細かく種類を絞ることができる。指定できる値は、mediaで指定した値によって分かれている。
movie … movieArtist, movie
podcast … podcastAuthor, podcast
music … musicArtist, musicTrack, album, musicVideo, mix, song
musicVideo … musicArtist, musicVideo
audiobook … audiobookAuthor, audiobook
shortFilm … shortFilmArtist, shortFilm
tvShow … tvEpisode, tvSeason
software … software, iPadSoftware, macSoftware
ebook … ebook
all … movie, album, allArtist, podcast, musicVideo, mix, audiobook, tvSeason, allTrack
attribute
商品のどの属性を、検索キーワードの対象とするのかを指定することができる。指定しない場合は、全ての属性を対象にする。例えば、人名で音楽(music)を検索したい場合は、artistTermを指定する。指定できる値は、mediaで指定した値によって分かれている。
movie … actorTerm, genreIndex, artistTerm, shortFilmTerm, producerTerm, ratingTerm, directorTerm, releaseYearTerm, featureFilmTerm, movieArtistTerm, movieTerm, ratingIndex, descriptionTerm
podcast … titleTerm, languageTerm, authorTerm, genreIndex, artistTerm, ratingIndex, keywordsTerm, descriptionTerm
music … mixTerm, genreIndex, artistTerm, composerTerm, albumTerm, ratingIndex, songTerm
musicVideo … genreIndex, artistTerm, albumTerm, ratingIndex, songTerm
audiobook … titleTerm, authorTerm, genreIndex, ratingIndex
shortFilm … genreIndex, artistTerm, shortFilmTerm, ratingIndex, descriptionTerm
tvShow … genreIndex, tvEpisodeTerm, showTerm, tvSeasonTerm, ratingIndex, descriptionTerm
software … softwareDeveloper
all … actorTerm, languageTerm, allArtistTerm, tvEpisodeTerm, shortFilmTerm, directorTerm, releaseYearTerm, titleTerm, featureFilmTerm, ratingIndex, keywordsTerm, descriptionTerm, authorTerm, genreIndex, mixTerm, allTrackTerm, artistTerm, composerTerm, tvSeasonTerm, producerTerm, ratingTerm, songTerm, movieArtistTerm, showTerm, movieTerm, albumTerm
callback
JavaScriptの関数名を指定すると、それがコールバック関数となる。
limit
取得件数を指定する。デフォルトは50で、150の間で指定可能となっている。
offset
公式ドキュメントにはないが、offsetパラメータを利用することで、ページングが可能になっている。
lang
言語を指定する。日本ならja_jp、英語ならen_us

サンプルリクエスト

例えば、Twitter(term=twitter)に関連したiPhone(entity=software)のアプリケーション(media=software)を検索するには、下記の通り、リクエストを組み立てます。試しにクリックしてアクセスしてみて下さいね。

https://itunes.apple.com/search?term=twitter&media=software&entity=software&country=jp&lang=ja_jp&limit=10 リンク

取得できるJSON

各種類の商品を検索した時に取得できるJSONデータをまとめました。それぞれ、2件ずつ、取得しています。

movie [映画]

JSONのサンプル

mediamovieを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"wrapperType":"track", "kind":"feature-movie", "trackId":556781619, "artistName":"ルパート・サンダーズ", "trackName":"スノーホワイト Snow White and the Huntsman(字幕版)", "trackCensoredName":"スノーホワイト Snow White and the Huntsman(字幕版)", "trackViewUrl":"https://itunes.apple.com/jp/movie/sunohowaito-snow-white-huntsman/id556781619?uo=4", "previewUrl":"http://a452.v.phobos.apple.com/us/r1000/102/Video/53/57/57/mzm.unmtnkze..640x362.h264lc.d2.p.m4v", "artworkUrl30":"http://is3.mzstatic.com/image/pf/us/r30/Video/v4/c7/9e/e4/c79ee4a0-6bdf-bb1a-270a-9d3b3467edf0/mza_6188944214365056615.30x30-50.jpg", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Video/v4/c7/9e/e4/c79ee4a0-6bdf-bb1a-270a-9d3b3467edf0/mza_6188944214365056615.60x60-50.jpg", "artworkUrl100":"http://is5.mzstatic.com/image/pf/us/r30/Video/v4/c7/9e/e4/c79ee4a0-6bdf-bb1a-270a-9d3b3467edf0/mza_6188944214365056615.100x100-75.jpg", "collectionPrice":1000.00, "trackPrice":1000.00, "trackRentalPrice":300.00000, "collectionHdPrice":1500.00000, "trackHdPrice":1500.00000, "trackHdRentalPrice":400.00000, "releaseDate":"2012-06-15T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "trackTimeMillis":7629887, "country":"JPN", "currency":"JPY", "primaryGenreName":"Action & Adventure", "contentAdvisoryRating":"R15+", "shortDescription":"(字幕版) 壮大なアクションアドベンチャー『スノーホワイト』で、クリステン・スチュワート(「トワイライト」シリーズ(08、09、10、11、12))が、国中で邪悪な女王(米アカデミー賞®", 
"longDescription":"(字幕版) 壮大なアクションアドベンチャー『スノーホワイト』で、クリステン・スチュワート(「トワイライト」シリーズ(08、09、10、11、12))が、国中で邪悪な女王(米アカデミー賞®受賞者シャーリーズ・セロン)より唯一美しさの勝るスノーホワイト役を演じている。女王は彼女を躍起になって殺そうとする。ところがこの悪魔の支配者が決して想像しなかったことが起こる。スノーホワイトは、自分を殺すために送られた猟師(クリス・ヘムズワース『マイティ・ソー』(11))から戦術兵法を学び、女王の支配を脅かしてきたのだ。ほかのキャストには、長い間スノーホワイトの美しさとパワーに魅せられてきた王子役でサム・クラフリン(『パイレーツ・オブ・カリビアン/生命(いのち)の泉』(11))が参加。『アリス・イン・ワンダーランド』(10)で製作を務めたジョー・ロス、『シックス・センス』(99)の製作に携わったサム・マーサー、そして高評価を受けるコマーシャル監督であり、最高級の映像作家ルパート・サンダースが、伝説の物語の、息をのむほど美しい新バージョンを、満を持して送り出した。"}, 
{"wrapperType":"track", "kind":"feature-movie", "trackId":398367814, "artistName":"ハン・サンヒ", "trackName":"初雪の恋~ヴァージン・スノー", "trackCensoredName":"初雪の恋~ヴァージン・スノー", "trackViewUrl":"https://itunes.apple.com/jp/movie/chu-xueno-lian-vu-ajin-suno/id398367814?uo=4", "artworkUrl30":"http://is5.mzstatic.com/image/pf/us/r30/Video/ae/ba/0d/mzi.foevmfod.30x30-50.jpg", "artworkUrl60":"http://is4.mzstatic.com/image/pf/us/r30/Video/ae/ba/0d/mzi.foevmfod.60x60-50.jpg", "artworkUrl100":"http://is1.mzstatic.com/image/pf/us/r30/Video/ae/ba/0d/mzi.foevmfod.100x100-75.jpg", "trackRentalPrice":300.00000, "trackHdRentalPrice":400.00000, "releaseDate":"2007-05-12T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "country":"JPN", "currency":"JPY", "primaryGenreName":"Romance", "contentAdvisoryRating":"G", 
"longDescription":"<初雪の日に逢う恋人たちは、ずうっと幸せになれる。トップスターが競演する、“切なく一途な”ラブストーリー>大学教授の父親に同行して、日本に転校することになったミン(イ・ジュンギ)。自転車に乗って京都の街を走り回った春の日、ミンは神社で巫女姿の七重(宮﨑あおい)と出会う。 彼女に一目惚れするミン。偶然にも七重は、ミンが転校した学校の生徒だった。七重に近づきたいミンの想いとは裏腹に、ミンはうっかり彼女の大切な画材ケースを川に落としてしまう。必死でアルバイトを探すミン。そして貯めたお金で買った、ミンの誠意がこもった真新しい画材ケースを受け取った七重は、その時から少しずつ、彼に心を開いていく。授業を抜け出した夏の日、陶器店に立寄った二人は、いつかミンが作った器に七重が絵を描くことを約束し合う。そして、初雪の日にソウルの石垣道を一緒に歩くことも。ミンは約束を実現するため、著名な陶芸家でもある父親に焼き物作りを教えてほしいと頼み込んだ。 真剣に陶芸に取り組み始めるミン。しかし、祇園祭の宵山の日を境に、七重は突然ミンの前から姿を消してしまう。絵皿作りの約束も、初雪の日に逢う約束も、叶えられないまま――"}]
}

各プロパティの説明

trackId
トラックID。Lookup APIのパラメータの値として利用する。
artistName
アーティスト名。監督名。
trackName
トラック名。映画名。
trackCensoredName
検閲されたトラック名。映画名。
trackViewUrl
App Store内の、作品ページのパーマリンク。
previewUrl
プレビューファイルのURLアドレス。
artworkUrl100
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
パッケージの料金。
trackPrice
トラックの料金。
trackHdPrice
トラック(HD)の料金。
trackRentalPrice
トラックのレンタル料金。
trackHdRentalPrice
トラック(HD)のレンタル料金。
releaseDate
発売日。
trackTimeMillis
作品の時間(ミリ秒)。
country
国。
currency
通貨。
primaryGenreName
ジャンル。
contentAdvisoryRating
年齢制限。
longDescription
作品の説明。

podcast [ポッドキャスト]

JSONのサンプル

mediapodcastを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"wrapperType":"track", "kind":"podcast", "collectionId":726500698, "trackId":726500698, "artistName":"Pillows and Blankets", "collectionName":"Pillows and Blankets", "trackName":"Pillows and Blankets", "collectionCensoredName":"Pillows and Blankets", "trackCensoredName":"Pillows and Blankets", "collectionViewUrl":"https://itunes.apple.com/jp/podcast/pillows-and-blankets/id726500698?mt=2&uo=4", "feedUrl":"http://www.the-gaffer.de/blog/category/pillows-blankets/feed/", "trackViewUrl":"https://itunes.apple.com/jp/podcast/pillows-and-blankets/id726500698?mt=2&uo=4", "artworkUrl30":"http://is3.mzstatic.com/image/pf/us/r30/Podcasts/v4/da/b9/03/dab90371-d7c8-0de6-5116-a8b01a827ddd/mza_6492386695030173968.30x30-50.jpg", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Podcasts/v4/da/b9/03/dab90371-d7c8-0de6-5116-a8b01a827ddd/mza_6492386695030173968.60x60-50.jpg", "artworkUrl100":"http://is2.mzstatic.com/image/pf/us/r30/Podcasts/v4/da/b9/03/dab90371-d7c8-0de6-5116-a8b01a827ddd/mza_6492386695030173968.100x100-75.jpg", "collectionPrice":0.00, "trackPrice":0.00, "trackRentalPrice":0, "collectionHdPrice":0, "trackHdPrice":0, "trackHdRentalPrice":0, "releaseDate":"2014-04-29T19:12:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "trackCount":10, "country":"JPN", "currency":"JPY", "primaryGenreName":"TV & Film", "artworkUrl600":"http://is3.mzstatic.com/image/pf/us/r30/Podcasts/v4/da/b9/03/dab90371-d7c8-0de6-5116-a8b01a827ddd/mza_6492386695030173968.600x600-75.jpg", "genreIds":["1309", "26"], "genres":["テレビ番組/映画", "Podcast"]}, 
{"wrapperType":"track", "kind":"podcast", "collectionId":779328595, "trackId":779328595, "artistName":"Dirty Pillows Podcast", "collectionName":"Dirty Pillows Podcast", "trackName":"Dirty Pillows Podcast", "collectionCensoredName":"Dirty Pillows Podcast", "trackCensoredName":"Dirty Pillows Podcast", "collectionViewUrl":"https://itunes.apple.com/jp/podcast/dirty-pillows-podcast/id779328595?mt=2&uo=4", "feedUrl":"http://feeds.soundcloud.com/users/soundcloud:users:66369230/sounds.rss", "trackViewUrl":"https://itunes.apple.com/jp/podcast/dirty-pillows-podcast/id779328595?mt=2&uo=4", "artworkUrl30":"http://is3.mzstatic.com/image/pf/us/r30/Podcasts4/v4/8b/39/5b/8b395bc0-e1e8-ff8f-53e6-9cfdcfac16b7/mza_5281168125669318364.30x30-50.jpg", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Podcasts4/v4/8b/39/5b/8b395bc0-e1e8-ff8f-53e6-9cfdcfac16b7/mza_5281168125669318364.60x60-50.jpg", "artworkUrl100":"http://is3.mzstatic.com/image/pf/us/r30/Podcasts4/v4/8b/39/5b/8b395bc0-e1e8-ff8f-53e6-9cfdcfac16b7/mza_5281168125669318364.100x100-75.jpg", "collectionPrice":0.00, "trackPrice":0.00, "trackRentalPrice":0, "collectionHdPrice":0, "trackHdPrice":0, "trackHdRentalPrice":0, "releaseDate":"2014-03-20T07:44:00Z", "collectionExplicitness":"explicit", "trackExplicitness":"explicit", "trackCount":9, "country":"JPN", "currency":"JPY", "primaryGenreName":"Comedy", "contentAdvisoryRating":"Explicit", "artworkUrl600":"http://is4.mzstatic.com/image/pf/us/r30/Podcasts4/v4/8b/39/5b/8b395bc0-e1e8-ff8f-53e6-9cfdcfac16b7/mza_5281168125669318364.600x600-75.jpg", "genreIds":["1303", "26"], "genres":["コメディ", "Podcast"]}]
}

各プロパティの説明

collectionId
ポッドキャストID。
trackId
トラックID。
artistName
アーティスト名。
collectionName
ポッドキャスト名。
trackName
トラック名。
collectionCensoredName
検閲されたポッドキャスト名。
trackCensoredName
検閲されたトラック名。
collectionViewUrl
App Store内の作品ページ(ポッドキャスト)のパーマリンク。
trackViewUrl
App Store内の作品ページ(トラック)のパーマリンク。
artworkUrl600
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
ポッドキャストの料金。
trackPrice
トラックの料金。
trackHdPrice
トラック(HD)の料金。
trackRentalPrice
トラックのレンタル料金。
trackHdRentalPrice
トラック(HD)のレンタル料金。
releaseDate
発売日。
trackCount
トラック数。
country
国。
currency
通貨。
primaryGenreName
ジャンル。

music [音楽]

JSONのサンプル

mediamusicを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"wrapperType":"track", "kind":"song", "artistId":94949844, "collectionId":317186212, "trackId":317186341, "artistName":"the pillows", "collectionName":"Rock stock & too smoking the pillows", "trackName":"Funny Bunny", "collectionCensoredName":"Rock stock & too smoking the pillows", "trackCensoredName":"Funny Bunny (Rock Stock Version)", "artistViewUrl":"https://itunes.apple.com/jp/artist/the-pillows/id94949844?uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/album/funny-bunny-rock-stock-version/id317186212?i=317186341&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/album/funny-bunny-rock-stock-version/id317186212?i=317186341&uo=4", "previewUrl":"http://a744.phobos.apple.com/us/r20/Music/v4/2f/53/63/2f536341-4614-7453-1275-d68fdc0df2e2/mzaf_7461742241849893593.aac.m4a", "artworkUrl30":"http://is2.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.30x30-50.jpg", "artworkUrl60":"http://is1.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.60x60-50.jpg", "artworkUrl100":"http://is4.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.100x100-75.jpg", "collectionPrice":-1.00, "trackPrice":250.00, "releaseDate":"2009-06-03T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "discCount":1, "discNumber":1, "trackCount":14, "trackNumber":10, "trackTimeMillis":206600, "country":"JPN", "currency":"JPY", "primaryGenreName":"Rock"}, 
{"wrapperType":"track", "kind":"song", "artistId":94949844, "collectionId":250034377, "trackId":250034390, "artistName":"the pillows", "collectionName":"スケアクロウ - EP", "trackName":"スケアクロウ", "collectionCensoredName":"スケアクロウ - EP", "trackCensoredName":"スケアクロウ", "artistViewUrl":"https://itunes.apple.com/jp/artist/the-pillows/id94949844?uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/album/sukeakurou/id250034377?i=250034390&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/album/sukeakurou/id250034377?i=250034390&uo=4", "previewUrl":"http://a1855.phobos.apple.com/us/r20/Music/v4/41/2d/19/412d19ef-64e9-90b2-b4e0-3252f26ef3f2/mzaf_3482494060362991602.aac.m4a", "artworkUrl30":"http://is3.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.30x30-50.jpg", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.60x60-50.jpg", "artworkUrl100":"http://is2.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.100x100-75.jpg", "collectionPrice":750.00, "trackPrice":250.00, "releaseDate":"2007-04-04T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "discCount":1, "discNumber":1, "trackCount":3, "trackNumber":1, "trackTimeMillis":272960, "country":"JPN", "currency":"JPY", "primaryGenreName":"Rock"}]
}

各プロパティの説明

artistId
アーティストID。
collectionId
アルバムID。
trackId
トラックID。
artistName
アーティスト名。
collectionName
アルバム名。
trackName
トラック名。
collectionCensoredName
検閲されたアルバム名。
trackCensoredName
検閲されたトラック名。
collectionViewUrl
App Store内の作品ページ(アルバム)のパーマリンク。
trackViewUrl
App Store内の作品ページ(トラック)のパーマリンク。
previewUrl
プレビューファイルのURLアドレス。
artworkUrl100
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
アルバムの料金。
trackPrice
トラックの料金。
trackHdPrice
発売日。
trackCount
トラック数。
trackNumber
このトラックの番号。
trackTimeMillis
演奏時間(ミリ秒)。
country
国。
currency
通貨。
primaryGenreName
ジャンル。

musicVideo [ミュージックビデオ]

JSONのサンプル

mediamusicVideoを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"wrapperType":"track", "kind":"song", "artistId":94949844, "collectionId":317186212, "trackId":317186341, "artistName":"the pillows", "collectionName":"Rock stock & too smoking the pillows", "trackName":"Funny Bunny", "collectionCensoredName":"Rock stock & too smoking the pillows", "trackCensoredName":"Funny Bunny (Rock Stock Version)", "artistViewUrl":"https://itunes.apple.com/jp/artist/the-pillows/id94949844?uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/album/funny-bunny-rock-stock-version/id317186212?i=317186341&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/album/funny-bunny-rock-stock-version/id317186212?i=317186341&uo=4", "previewUrl":"http://a744.phobos.apple.com/us/r20/Music/v4/2f/53/63/2f536341-4614-7453-1275-d68fdc0df2e2/mzaf_7461742241849893593.aac.m4a", "artworkUrl30":"http://is2.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.30x30-50.jpg", "artworkUrl60":"http://is1.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.60x60-50.jpg", "artworkUrl100":"http://is4.mzstatic.com/image/pf/us/r30/Music/5f/13/2f/mzi.jmusphex.100x100-75.jpg", "collectionPrice":-1.00, "trackPrice":250.00, "releaseDate":"2009-06-03T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "discCount":1, "discNumber":1, "trackCount":14, "trackNumber":10, "trackTimeMillis":206600, "country":"JPN", "currency":"JPY", "primaryGenreName":"Rock"}, 
{"wrapperType":"track", "kind":"song", "artistId":94949844, "collectionId":250034377, "trackId":250034390, "artistName":"the pillows", "collectionName":"スケアクロウ - EP", "trackName":"スケアクロウ", "collectionCensoredName":"スケアクロウ - EP", "trackCensoredName":"スケアクロウ", "artistViewUrl":"https://itunes.apple.com/jp/artist/the-pillows/id94949844?uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/album/sukeakurou/id250034377?i=250034390&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/album/sukeakurou/id250034377?i=250034390&uo=4", "previewUrl":"http://a1855.phobos.apple.com/us/r20/Music/v4/41/2d/19/412d19ef-64e9-90b2-b4e0-3252f26ef3f2/mzaf_3482494060362991602.aac.m4a", "artworkUrl30":"http://is3.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.30x30-50.jpg", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.60x60-50.jpg", "artworkUrl100":"http://is2.mzstatic.com/image/pf/us/r30/Music/a4/bf/9a/mzi.olzliwhy.100x100-75.jpg", "collectionPrice":750.00, "trackPrice":250.00, "releaseDate":"2007-04-04T07:00:00Z", "collectionExplicitness":"notExplicit", "trackExplicitness":"notExplicit", "discCount":1, "discNumber":1, "trackCount":3, "trackNumber":1, "trackTimeMillis":272960, "country":"JPN", "currency":"JPY", "primaryGenreName":"Rock"}]
}

各プロパティの説明

artistId
アーティストID。
collectionId
アルバムID。
trackId
トラックID。
artistName
アーティスト名。
collectionName
アルバム名。
trackName
トラック名。
collectionCensoredName
検閲されたアルバム名。
trackCensoredName
検閲されたトラック名。
collectionViewUrl
App Store内の作品ページ(アルバム)のパーマリンク。
trackViewUrl
App Store内の作品ページ(トラック)のパーマリンク。
previewUrl
プレビューファイルのURLアドレス。
artworkUrl100
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
アルバムの料金。
trackPrice
トラックの料金。
trackHdPrice
発売日。
discCount
ディスク数。
discNumber
このディスクの番号。
trackCount
トラック数。
trackNumber
このトラックの番号。
trackTimeMillis
演奏時間(ミリ秒)。
country
国。
currency
通貨。
primaryGenreName
ジャンル。

audiobook [オーディオブック]

JSONのサンプル

mediaaudiobookを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"wrapperType":"audiobook", "artistId":134419387, "collectionId":135048052, "artistName":"宮部みゆき", "collectionName":"日暮らし  全十二話完全版", "collectionCensoredName":"日暮らし  全十二話完全版", "artistViewUrl":"https://itunes.apple.com/jp/artist/gong-bumiyuki/id134419387?mt=11&uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/audiobook/ri-murashi-quan-shi-er-hua/id135048052?uo=4", "artworkUrl60":"http://is1.mzstatic.com/image/pf/us/r30/Music/08/c3/1a/mzi.ydaqcuqh.60x60-50.jpg", "artworkUrl100":"http://is5.mzstatic.com/image/pf/us/r30/Music/08/c3/1a/mzi.ydaqcuqh.100x100-75.jpg", "collectionPrice":1400.00, "collectionExplicitness":"notExplicit", "trackCount":1, "copyright":"℗ © 2003 朝日放送", "country":"JPN", "currency":"JPY", "releaseDate":"2003-04-28T07:00:00Z", "primaryGenreName":"Audiobooks", "previewUrl":"http://a989.phobos.apple.com/us/r30/Music/v4/c1/24/cb/c124cb06-5133-f907-15c2-3bcda3cd84cd/mzaf_3107150556046177346.aac.m4a", "description":"人気作「ぼんくら」の続編。江戸の町で次々と起こる事件を、なまくら同心「井筒平四郎」が甥の「弓之助」とともに解決する時代劇ミステリー。全12話の完全版。ABCラジオで放送された話題作が遂に登場! 江戸の風俗を紹介する「散歩道」のコーナーも収録。 (C)宮部みゆき (P)朝日放送"}, 
{"wrapperType":"audiobook", "artistId":134419387, "collectionId":135048200, "artistName":"宮部みゆき", "collectionName":"ぼんくら  全十二話完全版", "collectionCensoredName":"ぼんくら  全十二話完全版", "artistViewUrl":"https://itunes.apple.com/jp/artist/gong-bumiyuki/id134419387?mt=11&uo=4", "collectionViewUrl":"https://itunes.apple.com/jp/audiobook/bonkura-quan-shi-er-hua-wan/id135048200?uo=4", "artworkUrl60":"http://is2.mzstatic.com/image/pf/us/r30/Music/a9/e7/02/mzi.qsllnduz.60x60-50.jpg", "artworkUrl100":"http://is5.mzstatic.com/image/pf/us/r30/Music/a9/e7/02/mzi.qsllnduz.100x100-75.jpg", "collectionPrice":1400.00, "collectionExplicitness":"notExplicit", "trackCount":1, "copyright":"℗ © 2003 朝日放送", "country":"JPN", "currency":"JPY", "releaseDate":"2003-04-28T07:00:00Z", "primaryGenreName":"Audiobooks", "previewUrl":"http://a1099.phobos.apple.com/us/r30/Music/v4/8e/e3/0d/8ee30d17-1be2-82e5-b5ce-0cfb34ed134f/mzaf_4004115167044936621.aac.m4a", "description":"江戸の町で次々と起こる事件を、なまくら同心「井筒平四郎」が甥の「弓之助」とともに解決する時代劇ミステリー。全12話の完全版。ABCラジオで放送された話題作が遂に登場! 江戸の風俗を紹介する「散歩道」のコーナーも収録。続編の「日暮らし」も好評配信中です。 (C)宮部みゆき (P)朝日放送"}]
}

各プロパティの説明

artistId
著者ID。
collectionId
オーディオID。
artistName
著者名。
collectionName
オーディオ名。
collectionCensoredName
検閲されたオーディオ名。
description
オーディオの紹介文。
artistViewUrl
App Store内の著者ページのパーマリンク。
collectionViewUrl
App Store内のオーディオページのパーマリンク。
previewUrl
オーディオページのプレビューファイルのURL。
artworkUrl100
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
オーディオの料金。
copyright
コピーライト。著作情報。
releaseDate
発売日。
country
国。
currency
通貨。
primaryGenreName
ジャンル。

software [アプリケーション]

JSONのサンプル

mediasoftwareを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"kind":"software", "features":["iosUniversal"], 
"supportedDevices":["iPad23G", "iPadFourthGen", "iPhone5s", "iPhone5c", "iPhone4", "iPadThirdGen", "iPhone6Plus", "iPhone6", "iPadMini", "iPadThirdGen4G", "iPhone5", "iPodTouchFifthGen", "iPad2Wifi", "iPhone4S", "iPadFourthGen4G", "iPadMini4G"], "advisories":[], "isGameCenterEnabled":false, "artistViewUrl":"https://itunes.apple.com/jp/artist/twitter-inc./id296415947?uo=4", "artworkUrl60":"http://a341.phobos.apple.com/us/r30/Purple3/v4/1b/a9/2b/1ba92bdb-a568-375a-74f8-e8e2fcee9416/ProductionAppIcon57x57.png", 
"screenshotUrls":["http://a2.mzstatic.com/jp/r30/Purple1/v4/c3/84/a9/c384a9fb-fb1b-5208-b6e8-cde6a2cde850/screen1136x1136.jpeg", "http://a4.mzstatic.com/jp/r30/Purple3/v4/cd/91/51/cd915154-6e1b-d393-c82d-07962368c762/screen1136x1136.jpeg", "http://a5.mzstatic.com/jp/r30/Purple3/v4/ba/d2/91/bad29177-666e-a9c9-4c5d-00452b5e500a/screen1136x1136.jpeg", "http://a2.mzstatic.com/jp/r30/Purple1/v4/c9/6f/57/c96f57a0-31c0-19e2-1d3a-c5fae2b32492/screen1136x1136.jpeg"], 
"ipadScreenshotUrls":["http://a2.mzstatic.com/jp/r30/Purple1/v4/5d/f6/ba/5df6ba29-4642-a699-cf65-128ba3ace0a3/screen480x480.jpeg", "http://a4.mzstatic.com/jp/r30/Purple1/v4/40/48/97/404897d1-723c-05dc-c8d9-473d1b5a31d2/screen480x480.jpeg", "http://a1.mzstatic.com/jp/r30/Purple5/v4/c2/f2/d6/c2f2d600-cb49-0e63-aeee-b24eb5a5dd4c/screen480x480.jpeg", "http://a5.mzstatic.com/jp/r30/Purple5/v4/66/56/2d/66562dcc-fdbf-4912-e374-f16c3c157e64/screen480x480.jpeg"], "artworkUrl512":"http://a1422.phobos.apple.com/us/r30/Purple3/v4/61/d6/26/61d62656-5cca-410b-10cd-330976b2b90d/mzl.oqvthxrx.png", "artistId":296415947, "artistName":"Twitter, Inc.", "genres":["ソーシャルネットワーキング", "ユーティリティ"], "price":0.00, "version":"6.23", 
"description":"Twitterは多くの人々とつながったり、自分を表現したり、大好きなものについていろいろ知ることができる無料のアプリです。\n\n有名人やスポーツ選手同士ののおしゃべりや、世界を轟かせるニュースの一報。コンサートやテレビイベント、スポーツの試合などの舞台裏などを見てみませんか。\n\n会話をはじめましょう。文章だけでなく、画像や動画をツイートしてフォロワーに伝えましょう。もしかしたらあなたのファンができるかもしれません。\n\nインスピレーション。ソーシャル。\n友だちに送る個人的なメッセージ。\nそれらすべてがリアルタイムで。身の回りで起きている大きなことから小さなことまで。", "currency":"JPY", "genreIds":["6005", "6002"], "releaseDate":"2009-10-09T19:50:00Z", "sellerName":"Twitter, Inc.", "bundleId":"com.atebits.Tweetie2", "trackId":333903271, "trackName":"Twitter", "primaryGenreName":"Social Networking", "primaryGenreId":6005, "releaseNotes":"バグの修正と安定性を向上", "minimumOsVersion":"7.0", "wrapperType":"software", "formattedPrice":"無料", "contentAdvisoryRating":"4+", "artworkUrl100":"http://a1422.phobos.apple.com/us/r30/Purple3/v4/61/d6/26/61d62656-5cca-410b-10cd-330976b2b90d/mzl.oqvthxrx.png", "trackCensoredName":"Twitter", 
"languageCodesISO2A":["AR", "NB", "CS", "DA", "NL", "EN", "FI", "FR", "DE", "HE", "HU", "ID", "IT", "JA", "KO", "MS", "PL", "PT", "RO", "RU", "ZH", "ES", "SV", "TH", "ZH", "TR", "UK", "VI"], "fileSizeBytes":"43630472", "sellerUrl":"https://about.twitter.com/ja/products/iphone", "trackViewUrl":"https://itunes.apple.com/jp/app/twitter/id333903271?mt=8&uo=4", "trackContentRating":"4+", "averageUserRating":2.5, "userRatingCount":106383}, 
{"kind":"software", "features":["iosUniversal"], 
"supportedDevices":["iPad23G", "iPhone-3GS", "iPhone5c", "iPhone4", "iPadThirdGen", "iPodTouchFourthGen", "iPhone6", "iPhone6Plus", "iPadThirdGen4G", "iPodTouchThirdGen", "iPhone5", "iPad3G", "iPadFourthGen4G", "iPadFourthGen", "iPhone5s", "iPadMini", "iPadWifi", "iPodTouchFifthGen", "iPad2Wifi", "iPhone4S", "iPadMini4G"], "advisories":["無制限のWebアクセス"], "isGameCenterEnabled":false, "artistViewUrl":"https://itunes.apple.com/jp/artist/jane-inc./id478844338?uo=4", "artworkUrl60":"http://a551.phobos.apple.com/us/r30/Purple3/v4/24/b0/d4/24b0d4ea-74dc-c6a6-dcb2-cb0007aefe9f/AppIcon57x57.png", 
"screenshotUrls":["http://a3.mzstatic.com/jp/r30/Purple3/v4/af/84/22/af842233-f8f8-e9df-6baf-6aecff15f78c/screen1136x1136.jpeg", "http://a3.mzstatic.com/jp/r30/Purple3/v4/a4/3a/b4/a43ab4a0-b52e-8001-27b0-76a9251a3ef9/screen1136x1136.jpeg", "http://a2.mzstatic.com/jp/r30/Purple3/v4/08/3b/f7/083bf7fa-4e37-0da6-d9bf-0c30605cdfe9/screen1136x1136.jpeg", "http://a5.mzstatic.com/jp/r30/Purple4/v4/03/db/07/03db07f2-2d08-c532-f1ab-5ac1ed567437/screen1136x1136.jpeg", "http://a1.mzstatic.com/jp/r30/Purple4/v4/10/d7/af/10d7af8e-1c19-fd21-6e26-9be1c2a4f1f8/screen1136x1136.jpeg"], 
"ipadScreenshotUrls":["http://a3.mzstatic.com/jp/r30/Purple4/v4/6a/7a/c9/6a7ac9cf-3a78-dbff-d83e-d2b6c9818502/screen480x480.jpeg", "http://a1.mzstatic.com/jp/r30/Purple4/v4/af/5d/ff/af5dff8f-24b1-8a4a-52cd-062bcf680932/screen480x480.jpeg", "http://a5.mzstatic.com/jp/r30/Purple4/v4/c2/01/00/c201009b-67ac-4494-8bcd-2bf20272a538/screen480x480.jpeg", "http://a5.mzstatic.com/jp/r30/Purple4/v4/75/9c/2e/759c2eb2-4313-6e8e-02b7-0dc678c56d4b/screen480x480.jpeg", "http://a3.mzstatic.com/jp/r30/Purple4/v4/e5/92/d3/e592d333-51e4-4f9e-9730-231161b0759c/screen480x480.jpeg"], "artworkUrl512":"http://a1838.phobos.apple.com/us/r30/Purple3/v4/6a/38/ea/6a38ea61-636e-8d2b-49f4-60747bf3e19d/mzl.mjkkshbs.png", "artistId":478844338, "artistName":"Jane, Inc.", "genres":["ソーシャルネットワーキング", "ユーティリティ"], "price":0.00, "version":"1.6.5", 
"description":"気になるタイムラインを自由に追加、Twitterに流れる情報をスワイプ操作でさくさく取得できます。\n一歩進んだTwitter体験をしたいあなたにぴったりのアプリです。\n\n■Janetterの主な特徴\n・ブックマークに登録したタイムラインをスワイプ操作で高速切り替え\n・ブックマークに登録したタイムラインを一括更新\n・マルチアカウント対応、新着ツイート確認にアカウント切り替えは不要\n・リストや検索等様々なタイムラインの表示に対応\n・ツイートタップで表示されるアイコンから返信やお気に入りを簡単に実行\n・ツイートの長押しで会話を表示\n・ツイートのタップ、ダブルタップ、長押し等に好きな動作を割り当て可能\n・内蔵ブラウザは右スワイプで、ビューアは下スワイプでページを素早く閉じられる\n・特定の単語、特定のユーザー、特定のアプリからのツイートをミュートで非表示に\n・気になるURLはあとで読む、Pocket、Instapaperに対応\n\n■プロ版と無料版の違い \n・タイムライン上部と内蔵ブラウザ下部のバナー広告(Lite版:あり 無料版:あり プロ版:なし) \n・DMの閲覧機能(Lite版:なし 無料版:あり プロ版:あり) \n・登録できるアカウント数(Lite版:制限なし 無料版:3個まで プロ版:7個まで)\n\n※無料版の新規ユーザーはLite版として動作します。 \n\n■不具合報告\n不具合報告は以下で受け付けています。\n-----------------------------------------\nTwitter : @Janetter_jp\nメール : support+iOS@janesoft.net\n-----------------------------------------\nレビューではなくこちらで報告お願いします。", "currency":"JPY", "genreIds":["6005", "6002"], "releaseDate":"2012-09-11T07:00:00Z", "sellerName":"Jane, Inc.", "bundleId":"net.janesoft.janetter-iPhone", "trackId":555594731, "trackName":"Janetter for Twitter", "primaryGenreName":"Social Networking", "primaryGenreId":6005, "releaseNotes":"●改善\n・画像読み込み時のスクロールのもたつきを軽減した", "minimumOsVersion":"5.0", "wrapperType":"software", "formattedPrice":"無料", "contentAdvisoryRating":"17+", "artworkUrl100":"http://a1838.phobos.apple.com/us/r30/Purple3/v4/6a/38/ea/6a38ea61-636e-8d2b-49f4-60747bf3e19d/mzl.mjkkshbs.png", "trackCensoredName":"Janetter for Twitter", "languageCodesISO2A":["EN", "JA"], "fileSizeBytes":"16043518", "averageUserRatingForCurrentVersion":4.0, "userRatingCountForCurrentVersion":948, "trackViewUrl":"https://itunes.apple.com/jp/app/janetter-for-twitter/id555594731?mt=8&uo=4", "trackContentRating":"17+", "averageUserRating":4.0, "userRatingCount":13531}]
}

各プロパティの説明

trackId
アプリのID。
trackName
アプリの名称。
trackCensoredName
検閲されたアプリの名称。
sellerUrl
販売元のURL(アプリのウェブサイト)。
trackContentRating
アプリのレーティング。
averageUserRating
アプリのレーティング(平均点)。
userRatingCount
アプリに評価をした人数。
fileSizeBytes
アプリのサイズ(Byte)。
supportedDevices
サポートしている端末。
languageCodesISO2A
サポートしている言語。
artistViewUrl
App Store内の開発者のパーマリンク。
trackViewUrl
App Store内のアプリのパーマリンク。
artworkUrl100
アートワーク。パッケージ画像。
isGameCenterEnabled
ゲームセンターに対応しているか。
screenshotUrls
スクリーンショットの画像。
ipadScreenshotUrls
スクリーンショットの画像(iPad版)。
artistId
開発者のID。
artistName
開発者の名称。
sellerName
販売元の名称。
price
料金。
formattedPrice
テキスト表示形式の料金。
version
バージョン。
description
アプリの紹介文。
releaseDate
発売日。
currency
通貨。
primaryGenreName
アプリのジャンル。
primaryGenreId
アプリのジャンルID。
minimumOsVersion
一番古い対応OS。

ebook [電子書籍]

JSONのサンプル

mediaebookを指定して、取得したサンプルです。

JSON

{
 "resultCount":2,
 "results": [
{"artistId":134419387, "artistName":"宮部みゆき", "genres":["哲学/思想", "ブック", "ノンフィクション"], "kind":"ebook", "price":600.00, 
"description":"人の業がなせる、恐ろしくも切ない怪談話の語り部・宮部みゆき。稀代のストーリーテラーが織りなす物語には、どんな思いがあったのか。『泣き童子』が話題の「三島屋変調百物語」シリーズをはじめ、物語の舞台を歩きながらその魅力を探る異色の怪談散策! さらに怪異の世界を縦横に語りつくす北村薫氏との特別対談に加え、“今だから読んでほしい”小説4編を厳選。ファン必携! 著者責任編集「宮部怪談」公式読本。", "currency":"JPY", "genreIds":["10091", "38", "9002"], "releaseDate":"2013-09-30T07:00:00Z", "trackId":718265890, "trackName":"宮部みゆきの江戸怪談散歩", "artistIds":[134419387], "formattedPrice":"¥600", "trackCensoredName":"宮部みゆきの江戸怪談散歩", "artistViewUrl":"https://itunes.apple.com/jp/artist/gong-bumiyuki/id134419387?mt=11&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/book/gong-bumiyukino-jiang-hu-guai/id718265890?mt=11&uo=4", "artworkUrl60":"http://is4.mzstatic.com/image/pf/us/r30/Publication/v4/aa/65/3c/aa653c96-e6db-7e69-3f25-e08a48ffe314/80614850A02738400000.60x60-50.jpg", "artworkUrl100":"http://is2.mzstatic.com/image/pf/us/r30/Publication/v4/aa/65/3c/aa653c96-e6db-7e69-3f25-e08a48ffe314/80614850A02738400000.100x100-75.jpg", "fileSizeBytes":20928125}, 
{"artistId":691090384, "artistName":"小野洋一郎 & 宮部みゆき", "genres":["マンガ", "ブック", "マンガ/グラフィックノベル", "ファンタジー"], "kind":"ebook", "description":"宮部みゆき×小野洋一郎 累計200万部を超えた最強コンビによる完全新作!! 新たなる冒険の旅へ――。大地震で家族と故郷を失ったマモル。瓦礫の街を彷徨っていた彼は、光の洩れる不思議な扉を見つける。扉の向こうは、見たことのない巨大な竜の棲む異世界だった――。", "currency":"JPY", "genreIds":["10016", "38", "9026", "50000074"], "releaseDate":"2014-09-09T07:00:00Z", "trackId":973381130, "trackName":"ブレイブ・ストーリー新説 ~十戒の旅人~ 1巻", "artistIds":[691090384, 134419387], "trackCensoredName":"ブレイブ・ストーリー新説 ~十戒の旅人~ 1巻", "artistViewUrl":"https://itunes.apple.com/jp/artist/xiao-ye-yang-yi-lang-gong/id691090384?mt=11&uo=4", "trackViewUrl":"https://itunes.apple.com/jp/book/bureibu-sutori-xin-shuo-shi/id973381130?mt=11&uo=4", "artworkUrl60":"http://is1.mzstatic.com/image/pf/us/r30/Publication1/v4/fb/f7/05/fbf70552-636a-b4f5-3b2e-8b57eec9c83d/BT000030365300100101900209.60x60-50.jpg", "artworkUrl100":"http://is1.mzstatic.com/image/pf/us/r30/Publication1/v4/fb/f7/05/fbf70552-636a-b4f5-3b2e-8b57eec9c83d/BT000030365300100101900209.100x100-75.jpg", "fileSizeBytes":100745859}]
}

各プロパティの説明

artistId
著者ID。
collectionId
書籍ID。
artistName
著者名。
collectionName
書籍名。
collectionCensoredName
検閲された書籍名。
description
書籍の紹介文。
artistViewUrl
App Store内の著者ページのパーマリンク。
collectionViewUrl
App Store内の書籍ページのパーマリンク。
artworkUrl100
アートワーク。パッケージ画像。サイズは数種類ある。
collectionPrice
書籍の料金。
copyright
コピーライト。著作情報。
releaseDate
発売日。
country
国。
currency
通貨。
primaryGenreName
ジャンル。