Skip to content

Instantly share code, notes, and snippets.

@iggym
Last active April 28, 2023 23:35
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
--------------------------------------------------------------------------------------------------------------------------
@andrea-dagostino
Copy link

Hello. Any idea if the resulting json is sorted by app rank? Thank you.

@damilolah
Copy link

Do you have any idea why Apple's RSS feed generator doesn't return result? https://rss.itunes.apple.com/api/v1/us/podcasts/top-podcasts/all/25/explicit.json

@e-anima
Copy link

e-anima commented Jan 2, 2022

itunes has the worst data when it comes to EANs. All coorrect eans give 0 results
https://itunes.apple.com/lookup?upc=9783867176576 | Harry Potter
https://itunes.apple.com/lookup?upc=9783837157185 | Stephen King Billy summers

Anyone else has like 0 results when it comes to EAN searches?

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