README
iTunes Package
The iTunes Search API allows you to place search fields in your website to search for content within the iTunes Store, App Store, iBooks Store and Mac App Store.
- Domain: iTunes
Custom datatypes:
Datatype | Description | Example |
---|---|---|
Datepicker | String which includes date and time | |
Map | String which includes latitude and longitude coma separated | |
List | Simple array | |
Select | String with predefined values | |
Array | Array of objects |
iTunes.search
Search for content within the iTunes Store, App Store, iBooks Store and Mac App Store.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchMovies
Search in movies.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of movieArtist, movie. |
attribute | Select | The attribute you want to search for in the stores, one of actorTerm, genreIndex, artistTerm, shortFilmTerm, producerTerm, ratingTerm, directorTerm, releaseYearTerm, featureFilmTerm, movieArtistTerm, movieTerm, ratingIndex, descriptionTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchPodcasts
Search in podcasts.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of podcastAuthor, podcast. |
attribute | Select | The attribute you want to search for in the stores, one of titleTerm, languageTerm, authorTerm, genreIndex, artistTerm, ratingIndex, keywordsTerm, descriptionTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchMusic
Search in music.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of musicArtist, musicTrack, album, musicVideo, mix, song. |
attribute | Select | The attribute you want to search for in the stores, one of mixTerm, genreIndex, artistTerm, composerTerm, albumTerm, ratingIndex, songTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchMusicVideos
Search music and videos content.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of musicArtist, musicVideo. |
attribute | Select | The attribute you want to search for in the stores, one of genreIndex, artistTerm, albumTerm, ratingIndex, songTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchAudiobooks
Search in audiobooks.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of audiobookAuthor, audiobook. |
attribute | Select | The attribute you want to search for in the stores, one of titleTerm, authorTerm, genreIndex, ratingIndex. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchShortFilms
Search in short films.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of shortFilmArtist, shortFilm. |
attribute | Select | The attribute you want to search for in the stores, one of genreIndex, artistTerm, shortFilmTerm, ratingIndex, descriptionTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchTvShows
Search in TV shows.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of tvEpisode, tvSeason. |
attribute | Select | The attribute you want to search for in the stores, one of genreIndex, tvEpisodeTerm, showTerm, tvSeasonTerm, ratingIndex, descriptionTerm. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchSoftwares
Search in softwares.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
entity | Select | The type of results you want returned, one of software, iPadSoftware, macSoftware. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.searchEbooks
Search in ebooks.
Field | Type | Description |
---|---|---|
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentById
Look up content by iTunes ID.
Field | Type | Description |
---|---|---|
contentId | String | Id of content for Retrieving. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentByUpc
Look up an album or video by its UPC.
Field | Type | Description |
---|---|---|
upc | String | UPC of album or video. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentByIsbn
Look up content by ISBN.
Field | Type | Description |
---|---|---|
isbn | String | International standard book number. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentByAmgAlbumId
Look up an album by its AMG Album ID
Field | Type | Description |
---|---|---|
amgAlbumId | List | AMG Album identifier or comma separated Ids. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentByAmgArtistId
Look up content by AMG artist ID.
Field | Type | Description |
---|---|---|
amgArtistId | List | AMG Artist Id or comma separated Ids. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
iTunes.getContentByAmgVideoId
Look up content by AMG Video ID.
Field | Type | Description |
---|---|---|
amgVideoId | List | AMG Video identire. |
term | String | The text string you want to search for. |
country | String | The two-letter country code for the store you want to search. |
media | Select | The media type you want to search for. The default is all. |
entity | Select | The type of results you want returned, relative to the specified media type. For example: movieArtist for a movie media type search. The default is the track entity associated with the specified media type. |
attribute | Select | The attribute you want to search for in the stores, relative to the specified media type. For example, if you want to search for an artist by name specify entity=allArtist&attribute=allArtistTerm. In this example, if you search for term=maroon, iTunes returns “Maroon 5” in the search results, instead of all artists who have ever recorded a song with the word “maroon” in the title. |
limit | Number | The number of search results you want the iTunes Store to return. In range 1 - 200.The default is 50. |
lang | Select | The language, English or Japanese, you want to use when returning search results. Specify the language using the five-letter codename. The default is en_us (English). |
Followers: 37
Resources:
Product Website API Creator:

Volodimir Kudriachenko
volodimir.kudriachenko
Log In to Rate API