Getting Started

Including Guggy in your project

Guggy SDK is based on the Swift 3 language.

In your podfile, insert the following line:

pod 'guggysdk' , "~> 1.0.4"

In every file referencing Guggy add the following

import guggysdk

In a starting point in your app make the following call:

try! Guggy.initialize(YOUR_API_KEY_HERE) // Throws an AlreadyInitialized error

In an exiting point in your app make the following call:


Creating GIFs

Make a call to createGug(). The returned GuggyResult will contain all possible URLs of stickers and animated GIFs in several formats and profiles.

You can provide createGug() with a dictionary of parameters to be sent with the request.

Currently the supported options are:

lang - A two character ISO 639-1 language code that will direct Guggy to use a specific language when extracting context and trending content.

createGug(_ text:String? = nil, userParams:[String:AnyObject]? = nil, onComplete: (GuggyResult?) -> Void)


Guggy.createGug(textField.text) { guggyResult in

    // Handle result
     // Example 1: Get all animated GIF previews
    for animatedResult in result.animated! {

        let previewURL = animatedResult.gif?.preview?.url

        // Show preview


    // Get the final result URL of the preview to be used once the user chosen
    let finalURL = guggyResult.animated?[0].gif?.lowQuality?.url

    // Example 2: Get first result of a sticker in webp format, original profile

    // Example 3: Get first result of an animated preview of a mp4 format with a secure URL (https)


To get trending sentences just call createGug() with no sentence (null). Providing a lang parameter will affect the results.