Filter iTunes search API results

14
votes

It seems like iTunes search API returns different results than the ones returned when searching on an iPhone device (also results are in different order).

Assuming I want the results to be identical to an iPhone device, how do I do that with the official search API?

Also, is there a way to filter out non-iPhone apps from the search results?

Search API URL

iPhone search URL

2
itunes-search-api

2 Answers

14
votes

The search stack developed for the store is a different algorithm than the search stack for developer tools.

That said, understand some of the following features of the developer tool (Search API) that are helpful:

  • "sort=popular" is the default order that results are returned. "sort=recent" is the alternative.

  • "entity=software" will return apps that are available on iPhone, iPod touch and Universal apps (that work on iPad) but if you want all iOS apps you should use "entity=software,iPadSoftware"

  • Focus your search term on the attribute you are trying to target. If you know your search term is a song title (and not an album name or artist name) then use "attribute=songTerm"

2
votes

You can use the following API URL to make app store search requests. After acquiring Chomp last year, it was reported that Apple was revamping their internal App Store search algorithms. That may have something to do with the differences you see using the iTunes search API and whatever API the App Store uses. Apple may have developed a separate API specifically for Apps and for use in the App Store that excludes other products like music, in order to improve performance.

http://itunes.apple.com/search?term=SEARCHTERM&country=us&entity=software&limit=100

So, you could do the following in order to get only software for iPhone, iPod touch, and Universal apps with a search term of 'Gameloft'.

http://itunes.apple.com/search?term=Gameloft&country=us&entity=software&limit=100

To include iPad apps in the search, use:

http://itunes.apple.com/search?term=Gameloft&country=us&entity=software,iPadSoftware&limit=100

Check out Apple's documentation for more options.

You can try out a working example I put together of the iTunes search API here. Example Search Tool