https://github.com/henrikah/kick-go-sdk
SDK for the Kick API and webhook service.
https://github.com/henrikah/kick-go-sdk
api go kick sdk webhook
Last synced: 4 months ago
JSON representation
SDK for the Kick API and webhook service.
- Host: GitHub
- URL: https://github.com/henrikah/kick-go-sdk
- Owner: henrikah
- License: mit
- Created: 2025-08-26T14:47:04.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-01-18T19:08:24.000Z (4 months ago)
- Last Synced: 2026-01-19T03:24:06.077Z (4 months ago)
- Topics: api, go, kick, sdk, webhook
- Language: Go
- Homepage:
- Size: 170 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Kick Go SDK
[](https://pkg.go.dev/github.com/henrikah/kick-go-sdk/v2)
[](LICENSE)
[](https://github.com/henrikah/kick-go-sdk/releases)
[](https://github.com/henrikah/kick-go-sdk/actions/workflows/main.yaml)
A Go SDK for interacting with the [Kick API](https://docs.kick.com/) and handling webhooks.
This SDK provides clients for accessing Kick's API and for processing webhook events. Designed to be easy to use.
---
## Features
- **API Client** – Access Kick API endpoints such as users, livestreams, events, and moderation.
- **OAuth Client** – Support for PKCE OAuth2 flow and app access tokens.
- **Webhook Client** – Handle incoming Kick webhook events securely using the public key.
- **Typed Event Data** – Handlers receive typed structs for each event type.
- **Combined Workflow** – Retrieve the webhook public key directly from the API to set up your webhook client automatically.
---
## Installation
```bash
go get github.com/henrikah/kick-go-sdk/v2
```
---
## Quickstart: API Client
```go
oAuthClient, err := kick.NewOAuthClient(kickapitypes.APIClientConfig{
ClientID: "your-client-id",
ClientSecret: "your-client-secret",
HTTPClient: http.DefaultClient,
})
if err != nil {
log.Fatalf("could not create OAuthClient: %v", err)
}
apiClient, err := kick.NewAPIClient(kickapitypes.APIClientConfig{
HTTPClient: http.DefaultClient,
})
if err != nil {
log.Fatalf("could not create APIClient: %v", err)
}
accessToken, err := oAuthClient.GetAppAccessToken(context.TODO())
if err != nil {
var apiErr *kickerrors.APIError
if errors.As(err, &apiErr) {
log.Fatalf("API error: %d %s", apiErr.StatusCode, apiErr.Message)
} else {
log.Fatalf("internal error: %v", err)
}
}
categorySearchData, err := apiClient.Category().SearchCategories(context.TODO(), accessToken, kickfilters.NewCategoriesFilter().WithNames([]string{"Software Development"}))
if err != nil {
var apiErr *kickerrors.APIError
if errors.As(err, &apiErr) {
log.Fatalf("API error: %d %s", apiErr.StatusCode, apiErr.Message)
} else {
log.Fatalf("internal error: %v", err)
}
}
log.Println("Found category:", categorySearchData.Data[0].Name)
```
---
## Quickstart: Webhook Client
```go
webhookClient, err := kick.NewWebhookClient("your-public-key")
if err != nil {
log.Fatalf("could not create WebhookClient: %v", err)
}
err = webhookClient.RegisterChatMessageSentHandler(func(
writer http.ResponseWriter,
request *http.Request,
headers kickwebhooktypes.KickWebhookHeaders,
data kickwebhooktypes.ChatMessageSent,
) {
writer.WriteHeader(http.StatusOK)
})
if err != nil {
log.Printf("error registering chat message sent handler: %v", err)
}
http.HandleFunc("/webhook", webhookClient.WebhookHandler)
```
---
## Quickstart: Combined API + Webhook Client
You can automatically retrieve the public key from the API and use it to set up the webhook client without manually copying the key.
```go
apiClient, err := kick.NewAPIClient(kickapitypes.APIClientConfig{
HTTPClient: http.DefaultClient,
})
if err != nil {
log.Fatalf("could not create APIClient: %v", err)
}
// Fetch the webhook public key directly from the API
publicKeyResp, err := apiClient.PublicKey().GetWebhookPublicKey(context.TODO())
if err != nil {
var apiErr *kickerrors.APIError
if errors.As(err, &apiErr) {
log.Fatalf("API error: %d %s", apiErr.StatusCode, apiErr.Message)
} else {
log.Fatalf("internal error: %v", err)
}
}
webhookClient, err := kick.NewWebhookClient(publicKeyResp.Data.PublicKey)
if err != nil {
log.Fatalf("could not create WebhookClient: %v", err)
}
// Register handlers
err = webhookClient.RegisterChatMessageSentHandler(func(writer http.ResponseWriter, request *http.Request, headers kickwebhooktypes.KickWebhookHeaders, data kickwebhooktypes.ChatMessageSent) {
writer.WriteHeader(http.StatusOK)
})
if err != nil {
log.Printf("error registering chat message sent handler: %v", err)
}
http.HandleFunc("/webhook", webhookClient.WebhookHandler)
```
---
## Disclaimer
The Kick API documentation is sometimes ambiguous. This SDK makes educational guesses about certain endpoints and behaviors. There may be limitations or quirks in the API that are not handled by this SDK.