Skip to content

Instantly share code, notes, and snippets.

@hising
Forked from iggym/gist:6023041
Created March 19, 2021 01:28
Show Gist options
  • Save hising/825407b6fcd614ffb110e92b12745293 to your computer and use it in GitHub Desktop.
Save hising/825407b6fcd614ffb110e92b12745293 to your computer and use it in GitHub Desktop.
Apple iTunes Search API and RSS feeds. --- Apple very usefully provides unauthenticated json feeds for both the iTunes search and iTunes rss
Apple very usefully provides unauthenticated json feeds for both the iTunes search and iTunes rss
The Search API returns your search results in JavaScript Object Notation (JSON) format. JSON is built on two structures:
All JSON results are encoded as UTF-8. For more information on JSON, please see http://www.json.org.
---
Search API
http://www.apple.com/itunes/affiliates/resources/documentation/itunes-store-web-service-search-api.html
---
RSS Info
http://www.apple.com/itunes/affiliates/resources/blog/introduction---rss-feed-generator.html
---
RSS Generator
http://itunes.apple.com/rss
--------------------------------------------------------------------------------------------------------------------------
Search Examples
---------------
The following are examples of fully-qualified URLs for specific search requests:
To search for all Jack Johnson audio and video content (movies, podcasts, music, music videos, audiobooks, short films, and tv shows), your URL would look like the following:
https://itunes.apple.com/search?term=jack+johnson
To search for all Jack Johnson audio and video content and return only the first 25 items, your URL would look like the following:
https://itunes.apple.com/search?term=jack+johnson&limit=25
To search for only Jack Johnson music videos, your URL would look like the following:
https://itunes.apple.com/search?term=jack+johnson&entity=musicVideo
To search for all Jim Jones audio and video content and return only the results from the Canada iTunes Store, your URL would look like the following:
https://itunes.apple.com/search?term=jim+jones&country=ca
To search for applications titled "Yelp" and return only the results from the United States iTunes Store, your URL would look like the following:
https://itunes.apple.com/search?term=yelp&country=us&entity=software
Lookup Examples
----------------
You can also create a lookup request to search for content in the stores based on iTunes IDs, UPCs/ EANs, and All Music Guide (AMG) IDs. ID-based lookups are faster and contain fewer false-positive results.
The following are examples of fully-qualified URLs for specific lookup requests:
Look up Jack Johnson by iTunes artist ID:
https://itunes.apple.com/lookup?id=909253
Look up Yelp Software application by iTunes ID:
https://itunes.apple.com/lookup?id=284910350
Look up Jack Johnson by AMG artist ID:
https://itunes.apple.com/lookup?amgArtistId=468749
Look up multiple artists by their AMG artist IDs:
https://itunes.apple.com/lookup?amgArtistId=468749,5723
Look up all albums for Jack Johnson:
https://itunes.apple.com/lookup?id=909253&entity=album
Look up multiple artists by their AMG artist IDs and get each artist's top 5 albums:
https://itunes.apple.com/lookup?amgArtistId=468749,5723&entity=album&limit=5
Look up multiple artists by their AMG artist IDs and get each artist's 5 most recent songs:
https://itunes.apple.com/lookup?amgArtistId=468749,5723&entity=song&limit=5&sort=recent
Look up an album or video by its UPC:
https://itunes.apple.com/lookup?upc=720642462928
Look up an album by its UPC, including the tracks on that album:
https://itunes.apple.com/lookup?upc=720642462928&entity=song
Look up an album by its AMG Album ID:
https://itunes.apple.com/lookup?amgAlbumId=15175,15176,15177,15178,15183,15184,15187,1519,15191,15195,15197,15198
Look up a Movie by AMG Video ID:
https://itunes.apple.com/lookup?amgVideoId=17120
Look up a book by its 13 digit ISBN:
https://itunes.apple.com/lookup?isbn=9780316069359
--------------------------------------------------------------------------------------------------------------------------
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment