dependencies {
    implementation("io.github.vyfor:klipy:$version")
    /* required */
    implementation("io.ktor:ktor-client-$engine:$version")
}

val klipy = KlipyClient("YOUR_APP_KEY")

// trending GIFs
val page = klipy.gifs().trending().perPage(20).send()
page.contentItems().forEach { println("${it.slug} - ${it.kind}") }

// search
val page = klipy.stickers().search("happy").contentFilter(ContentFilter.Medium).send()

// fetch by slug
val page = klipy.clips().items("they-love-me-spider-man")

// log a share
klipy.gifs().share("hello-hi-662").customerId("user-uuid").send()

// search suggestions
val suggestions = klipy.searchSuggestions("hel", limit = 10)

val klipy = KlipyClient("YOUR_APP_KEY") {
    userAgent("Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148")
}

val page = klipy.gifs().trending()
    .adParams(AdParams(
        customerId = "user-uuid",
        minWidth = 50,
        maxWidth = 400,
        minHeight = 50,
        maxHeight = 250,
        os = "ios",
    ))
    .send()

for (item in page.data) {
    when (item) {
        is Item.Content -> { /* display item.value */ }
        is Item.Ad -> { /* render item.value.content (either HTML or iFrame) */ }
    }
}

val klipy = KlipyClient("YOUR_APP_KEY") {
    userAgent("...")
}

val klipy = KlipyClient("YOUR_APP_KEY") {
    httpClient(myClient)
}