Skip to content

Instantly share code, notes, and snippets.

@iggym
Last active October 11, 2024 18:21
Show Gist options
  • Save iggym/6023041 to your computer and use it in GitHub Desktop.
Save iggym/6023041 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
--------------------------------------------------------------------------------------------------------------------------
@BlueDome77
Copy link

BlueDome77 commented Oct 11, 2024

Extra period in the json website link giving me a 404 error when click it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment