Latest 1.1.0-beta1
License Apache2
Platforms ios 6.0, requires ARC
Dependencies UIImage-ResizeMagick
Frameworks UIKit, StoreKit, CoreGraphics, MobileCoreServices



The Kik API library for iOS supports iOS versions >= 6.0.


You can install the Kik API using CocoaPods. To include the library,
simply add the following line to the Podfile in your project:

pod "KikAPI"


Opening a Kik User Profile

[[KikClient sharedInstance] openProfileForKikUsername:@"kikteam"];

Sending a Kik Content Message

Two layout styles are available for your content messages: article and photo. You can specify the layout style that
best suits your content when composing the content message to send.

To send a content message using the API you must construct a KikMessage object with the parameters of your message
and send it using the sendKikMessage method on KikClient. The examples in the following sections will show you how
to construct and send article and photo content messages.


KikMessage *message = [KikMessage articleMessageWithTitle:@"Title of your Article"
                                                     text:@"Text of your Article"

[[KikClient sharedInstance] sendKikMessage:message];
  • One of either Title or text must be specified
  • The contentURL must be specified. This is the target URL that will be opened when the user taps on the message in Kik
  • previewURL is an optional image URL that can be specified to provide a thumbnail preview that will be displayed in your message


// Create a photo message using URLs
KikMessage *message = [KikMessage photoMessageWithImageURL:@""

[[KikClient sharedInstance] sendKikMessage:message];

When sending an image URL, you can choose to specify a base64-encoded Data URI in place of a standard web URL. In this case, the data will be uploaded
and downloaded from the Kik servers instead of directly accessing the image via the provided web URL.

Alternatively, you can specify a UIImage as the photo to send.

// Create a photo message from an UIImage object
UIImage *image = [UIImage imageNamed:@"image.png"];
KikMessage *message = [KikMessage photoMessageWithImage:image];

Other Message Attributes


If you do not want to allow a user to forward a particular content message on to a friend you can set the forwardable attribute on a KikMessage to NO. The default value for forwardable is YES.

message.forwardable = NO;

Fallback URLs

With any content message, you can specify fallback URLs. When the user opens your content message, Kik will check your fallback URLs to see which URL is supported on the current platform and display a link to the user which will allow them to navigate to that URL.

A fallback URL can be any type of URL whether it is a link to a website (ie. or a specialized scheme for a native app (ie. kik://users/kikteam/profile).

If your app supports both Android and iOS, you can add a link to the native scheme which would open your app on each respective platform. Also, if your app is not installed, Kik will detect that your native scheme is not handled. If this is the case, the next fallback URL in order will be presented to the user. This is an opportunity to add another fallback URL linking to the AppStore with an ITMS link or the Google Play Store with a web link.

- (void)addFallbackURL:(NSString *)fallbackURL
// launch the app first if available
[message addFallbackURL:@"test-iphone://api/launch" forPlatform:KikMessagePlatformiPhone];
[message addFallbackURL:@"test-android://api/launch" forPlatform:KikMessagePlatformAndroid];

// fallback to launching the app store on the given platform
[message addFallbackURL:@"itms-apps://" forPlatform:KikMessagePlatformiPhone];
[message addFallbackURL:@"" forPlatform:KikMessagePlatformAndroid];

Returning to Kik After Opening Content

When the user taps your content from within Kik and launches your app, they will want to return to Kik to continue their chat. From within your app, use the backToKik method to return the user to their active chat once they have viewed the content in your app.

[[KikClient sharedInstance] backToKik];

Example Project

To run the example project, clone the repo, and run pod install from the "Example" directory first.


Kik Interactive, Inc.


Use of the Kik API is subject to the Terms & Conditions and the Acceptable Use Policy. See for details.

The source for KikAPI is available under the Apache 2.0 license. See the file for details.

Latest podspec

    "name": "KikAPI",
    "version": "1.1.0-beta1",
    "summary": "Native API for interacting with the Kik Messenger client.",
    "homepage": "",
    "license": "Apache2",
    "authors": {
        "Kik Interactive": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.1.0-beta1"
    "social_media_url": "",
    "platforms": {
        "ios": "6.0"
    "requires_arc": true,
    "source_files": "Pod/Classes",
    "resources": "Pod/Assets/*.png",
    "frameworks": [
    "dependencies": {
        "UIImage-ResizeMagick": []

Pin It on Pinterest

Share This