/InstagramKit

Instagram iOS SDK

Primary LanguageObjective-CMIT LicenseMIT

InstagramKit

CI Status Version License Platform

An extensive Objective C wrapper for the Instagram API.

Here's a quick example to retrieve trending media on Instagram:

InstagramEngine *engine = [InstagramEngine sharedEngine];
[engine getPopularMediaWithSuccess:^(NSArray *media, InstagramPaginationInfo *paginationInfo) {
    // media is an array of InstagramMedia objects
    ...
} failure:^(NSError *error, NSInteger statusCode) {
    ...
}];

The framework is built atop AFNetworking’s blocks-based architecture and additionally, parses JSON data and creates model objects asynchronously so there’s absolutely no parsing on the main thread. It’s neat, fast and works like a charm.

####Installation

Getting started is easy. Just include the files from the directory 'InstagramKit' into your project and you'll be up and running. You may need to add AFNetworking to your project as well if you haven't already.

####Cocoapods Podfile

pod 'InstagramKit', '~> 3.0'

####Compatibility Earliest supported deployment target = iOS 6

####Instagram Developer Registration Head over to http://instagram.com/developer/clients/manage/ to register your app with Instagram and insert the right credentials into your App's Info.plist file.

####Authentication and Usage

For detailed instructions on configuring, authenticating and using InstagramKit, refer to the Authentication Guide. Download and run the Demo Project to understand how the engine is intended to be used.

Note: To use POST or DELETE requests to change likes, comments or follows, you must apply to Instagram here.

Read about implementing Pagination for your requests effortlessly in the Pagination Wiki.

####Contributions?

Glad you asked. Check out the open Issues and jump right in. Please submit pull requests to the dev branch.

####Questions? The Instagram API Documentation is your definitive source of information in case something goes wrong. Please make sure you've read up the documentation before posting issues.

==================

InstagramKit uses the public Instagram API and is not affiliated with either Instagram or Facebook.

If you're using InstagramKit in your App or intend to, I'd be happy to hear from you.

~ @bhatthead