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.
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 |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |
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). |