We are no longer maintaining this repository! Please head over to the new GIPHY SDK for the best and easiest way to add GIPHY to your app.

Giphy Core SDK for Swift

The Giphy Core SDK is a wrapper around Giphy API.

Giphy is the best way to search, share, and discover GIFs on the Internet. Similar to the way other search engines work, the majority of our content comes from indexing based on the best and most popular GIFs and search terms across the web. We organize all those GIFs so you can find the good content easier and share it out through your social channels. We also feature some of our favorite GIF artists and work with brands to create and promote their original GIF content.

Getting Started

Supported Platforms

• iOS
• macOS
• tvOS
• watchOS

Supported End-points

• Search GIFs/Stickers
• Trending GIFs/Stickers
• Random GIFs/Stickers
• GIF by ID
• GIFs by IDs

Advanced Usage

• Filtering
• User Dictionaries

Setup

CocoaPods Setup

Add the GiphyCoreSDK entry to your Podfile

pod 'GiphyCoreSDK'

Run pods to grab the GiphyCoreSDK framework

pod install

Carthage Setup

Add the GiphyCoreSDK entry to your Cartfile

git "git@github.com:Giphy/giphy-ios-sdk-core.git" "master"

Run carthage update to grab the GiphyCoreSDK framework

carthage update

Swift Package Manager Setup

• Add .package(url:"https://github.com/Giphy/giphy-ios-sdk-core", from: "1.2.0") to your package dependencies.
• Then add GiphyCoreSDK to your target dependencies.

Initialize Giphy SDK

// Configure your API Key
GiphyCore.configure(apiKey: "YOUR_API_KEY")

Search Endpoint

Search all Giphy GIFs for a word or phrase. Punctuation will be stripped and ignored.

/// Gif Search
let op = GiphyCore.shared.search("cats") { (response, error) in

    if let error = error as NSError? {
        // Do what you want with the error
    }

    if let response = response, let data = response.data, let pagination = response.pagination {
        print(response.meta)
        print(pagination)
        for result in data {
            print(result)
        }
    } else {
        print("No Results Found")
    }
}

/// Sticker Search
let op = GiphyCore.shared.search("dogs", media: .sticker) { (response, error) in
    //...
}

Trending Endpoint

Fetch GIFs currently trending online. Hand curated by the Giphy editorial team. The data returned mirrors the GIFs showcased on the Giphy homepage.

/// Trending GIFs
let op = GiphyCore.shared.trending() { (response, error) in
    //...
}

/// Trending Stickers
let op = GiphyCore.shared.trending(.sticker) { (response, error) in
    //...
}

Random Endpoint

Returns a random GIF, limited by tag. Excluding the tag parameter will return a random GIF from the Giphy catalog.

/// Random GIF
let op = GiphyCore.shared.random("cats") { (response, error) in

    if let error = error as NSError? {
        // Do what you want with the error
    }

    if let response = response, let data = response.data  {
        print(response.meta)
        print(data)
    } else {
        print("No Result Found")
    }
}

/// Random Sticker
let op = GiphyCore.shared.random("cats", media: .sticker) { (response, error) in
    //...
}

Get GIF by ID Endpoint

Returns meta data about a GIF, by GIF id. In the below example, the GIF ID is "feqkVgjJpYtjy"

/// Gif by Id
let op = GiphyCore.shared.gifByID("feqkVgjJpYtjy") { (response, error) in
    //...
}

Get GIFs by IDs Endpoint

A multiget version of the get GIF by ID endpoint. In this case the IDs are feqkVgjJpYtjy and 7rzbxdu0ZEXLy.

/// GIFs by Ids
let ids = ["feqkVgjJpYtjy", "7rzbxdu0ZEXLy"]

let op = GiphyCore.shared.gifsByIDs(ids) { (response, error) in

    if let error = error as NSError? {
        // Do what you want with the error
    }

    if let response = response, let data = response.data, let pagination = response.pagination {
        print(response.meta)
        print(pagination)
        for result in data {
            print(result)
        }
    } else {
        print("No Result Found")
    }
}

Advanced Usage

Filtering Models

We added support for you to filter results of any models out during requests. Here are few use cases below in code:

GiphyCore.setFilter(filter: { obj in
            if let obj = obj as? GPHMedia {
                
                // Check to see if this Media object has tags
                // Say we only want GIFs/Stickers with tags, otherwise filter them out
                return obj.tags == nil
                
            } else if let obj = obj as? GPHChannel {
            
                // We only want channels which have featured Gifs
                return obj.featuredGif != false
            }
            
            // Otherwise this is a valid object, don't filter it out
            return true
        })

User Dictionaries

We figured you might want to attach extra data to our models such us GPHMedia .. so now all our models have userDictionary which you can attach any sort of object along with any of our models.

/// Gif Search
let op = GiphyCore.shared.search("cats") { (response, error) in

    if let error = error as NSError? {
        ......
    }

    if let response = response, let data = response.data, let pagination = response.pagination {
        for result in data {
            result.userDictionary = ["Description" : "Results from Cats Search"]
        }
    } else {
        print("No Results Found")
    }
}