Skip to content
Cocoa wrapper for the iTunes search API - for iOS and Mac OSX projects
Objective-C Ruby
Find file
New pull request
Latest commit 2f0ab61 @andysmart Merge pull request #6 from sdgandhi/master
Update AFNetworking version in Podspec


AJSiTunesAPI is a simple, asynchronous Cocoa API controller and object for searching the iTunes Search API on either Mac OSX or iOS projects.

This library is a work-in-progress, but current features should work as expected. Support for iTunes lookups from artist ID is omitted, and planned.


AJSITunesAPI 0.2.0 uses the latest version of AFNetworking, and as a result is compatible only with project supporting iOS7, or OSX 10.9 Mavericks.


For a rundown of the type of results to expect, source documentation of the API can be found here:

Results are parsed to Cocoa objects, with properties for most of the returned data. Check the header files for data types and properties supported.


Installation is super easy, using Cocoapods. Just add the pod 'AJSITunesAPI', :git => '' to your Podfile and run pod install.


AJSITunesAPI is now fully block based, and much simpler as a result. Use one of the two convenience methods on AJSITunesClient, and receive an NSArray of AJSITunesResult objects.

AJSITunesClient *client = [AJSITunesClient sharedClient];
[client searchMedia:@"batman" completion:^(NSArray *results, NSError *error) {
    NSLog(@"Finished with results: %@", results);

Or, if you need a bit more control:

AJSITunesClient *client = [AJSITunesClient sharedClient];
[client searchMediaWithType:AJSITunesMediaTypeMovie
completion:(NSArray *results, NSError *error) {
    NSLog(@"Finished with results: %@", results);


Standard MIT deal, see LICENSE for details.

Something went wrong with that request. Please try again.