KickLogz API vv1

KickLogz API Dokümantasyonu

Yayıncı analitiği, hesap meta verileri ve geçmiş arama iş akışları için salt okunur erişim.

API erişimi satın al API anahtarı oluştur

Genel

Bağlantı detayları

Base URL, auth header ve temel API bilgileri.

Bağlantı detayları

Base URL https://kicklogz.com/api/customer/v1

Base path /api/customer/v1

Auth header x-kicklogz-api-key

API anahtarı örneği klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Genel bakış

Dokümante edilen endpoint'ler 67

Canlıda 67

Yakında 0

Katalog endpoint'i yalnızca doğrulanmış anahtarın şu anda kullanabildiği yayına açık endpoint'leri döndürür.

Arama asenkrondur: önce bir iş oluşturun, ardından tamamlanana kadar iş durum endpoint'ini sorgulayın.

Arama endpoint'leri, paket searchUnitCostMultiplier değeri ile çarpılan temel unit ücretini kullanır.

Sayfa boyutu ve tarih aralığı limitleri endpoint'e ve hesap paketine bağlıdır; her istekte sunucu tarafında uygulanır.

Hızlı kurulum

KickLogz API'yi kullanmaya başla

Erişim satın almak, anahtar oluşturmak ve ilk isteğini göndermek için bu adımları izle.

Hızlı kurulum

1. Erişim satın alın
Paketler sayfasından bir KickLogz API paketi satın alın.
Paketleri aç
2. Bir API anahtarı oluşturun
Profile > KickLogz API bölümünü açın ve izin verilen yayıncı kapsamı ile endpoint ailelerini seçerek bir anahtar oluşturun.
Profili aç
3. Salt okunur istekler gönderin
Her istekte x-kicklogz-api-key kullanın. Çoğu endpoint salt okunurdur; management endpoint'leri anahtarın ilgili aileye erişimi olduğunda hesap yapılandırmasını güncelleyebilir.

curl -X GET "https://kicklogz.com/api/customer/v1/account" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Paketler ve limitler

Mevcut paketler

Paketin hız, kota ve yayıncı limitlerini inceleyin.

Starter 1 Yayıncı

1 streamer
20 RPM
1 concurrency
12,000 monthly units
3 day search window

Scale 50 Yayıncı

50 streamers
60 RPM
3 concurrency
150,000 monthly units
7 day search window

Enterprise Sınırsız

Unlimited streamers
120 RPM
6 concurrency
1,000,000 monthly units
14 day search window

Hatalar

Hata yanıt formatı

KickLogz API tarafından döndürülen standart JSON hata zarfı.

{
  "success": false,
  "status": 429,
  "error": "customer_api_rate_limit_exceeded",
  "message": "Per-minute rate limit exceeded.",
  "details": {
    "family": "streamer_profile",
    "rpmLimit": 20,
    "currentMinuteCount": 21
  },
  "retryAfterSeconds": 15
}

Kimlik doğrulama ve erişim 8

customer_api_key_required HTTP 401

Provide x-kicklogz-api-key or Bearer token.

The request did not include a KickLogz API key.

customer_api_key_invalid HTTP 401

Invalid or inactive KickLogz API key.

The key format, hash, or account state is not valid.

customer_api_ip_not_allowed HTTP 403

Requester IP is not allowlisted for this key.

The API key is restricted to specific IP addresses.

customer_api_family_disabled HTTP 403

Endpoint family is not enabled for this account.

The subscription plan or account settings do not allow this family.

customer_api_family_disabled_for_key HTTP 403

Endpoint family is not enabled for this API key.

The key exists, but it was scoped down to fewer endpoint families.

customer_api_streamer_required HTTP 400

Streamer scope is required for this endpoint.

A streamer slug or equivalent scoped identifier is required.

customer_api_streamer_not_allowed_for_key HTTP 403

Streamer is not allowed for this API key.

The streamer exists on the account, but this specific key cannot read it.

customer_api_streamer_not_entitled HTTP 403

Streamer is not entitled for this account.

The account does not currently have access to the requested streamer.

Kota ve istek doğrulama 13

customer_api_broadcast_id_invalid HTTP 400

broadcastId must be a positive integer.

Broadcast-scoped endpoints require a valid numeric broadcast identifier.

customer_api_subscription_type_invalid HTTP 400

Subscription type is invalid.

type must be one of: all, normal, or gifted.

customer_api_username_required HTTP 400

username is required.

Kick profile endpoints require a username path parameter.

customer_api_username_invalid HTTP 400

username must be between 2 and 255 characters.

The supplied username is empty or outside the allowed length range.

customer_api_page_size_invalid HTTP 400

Page size must be inside the endpoint maximum.

limit/pageSize must be between 1 and the endpoint maximum. KickLogz API search supports up to 250 results per request.

customer_api_date_window_invalid HTTP 400

Invalid date window.

The request date range is malformed or the end date is earlier than the start date.

customer_api_date_window_too_wide HTTP 400

Date window exceeds the plan maximum.

The date range is wider than the plan allows for that endpoint family.

customer_api_rate_limit_exceeded HTTP 429

Per-minute rate limit exceeded.

Respect the Retry-After header or retryAfterSeconds field before sending more requests.

customer_api_concurrency_limit_exceeded HTTP 429

Concurrent request limit exceeded.

Too many requests are currently in flight for the account or family.

customer_api_monthly_request_limit_exceeded HTTP 429

Monthly request limit exceeded.

The account has exhausted its monthly request allowance.

customer_api_monthly_unit_limit_exceeded HTTP 429

Monthly unit limit exceeded.

The account has exhausted its monthly unit budget.

customer_api_streamer_limit_reached HTTP 409

Streamer limit reached for this API account.

Remove an existing streamer entitlement, add capacity, or upgrade the account before adding another streamer.

customer_api_remove_24h_limit_exceeded HTTP 409

24-hour streamer removal limit reached.

The account has reached its monthly allowance for removing streamers within 24 hours of adding them.

Arama iş akışı 16

customer_api_channel_required HTTP 400

channelName is required.

A search request must include a channel slug or resolve path parameter.

customer_api_channel_not_found HTTP 404

Channel not found.

KickLogz could not resolve the requested channel.

customer_api_search_date_range_required HTTP 400

dateFrom and dateTo are required for KickLogz API search.

Historical search always requires a bounded date window.

customer_api_search_date_range_invalid HTTP 400

dateFrom and dateTo must form a valid forward date window.

Search dates must be valid and dateTo cannot be earlier than dateFrom.

customer_api_search_criteria_required HTTP 400

Provide query or username for KickLogz API search.

At least one search criterion must be present.

customer_api_search_share_criteria_required HTTP 400

Provide query or username for KickLogz API shared search.

A shared search link must include a query term or an exact username filter.

customer_api_search_query_too_short HTTP 400

query must be at least 3 characters for KickLogz API search.

Free-text search terms shorter than the configured minimum are rejected.

customer_api_search_username_too_short HTTP 400

username must be at least 2 characters for KickLogz API search.

Username criteria shorter than the configured minimum are rejected.

customer_api_search_old_usernames_limit_exceeded HTTP 400

oldUsernames may include at most 5 entries.

Too many historical usernames were supplied.

customer_api_search_lists_not_supported HTTP 400

Search lists are not supported in KickLogz API.

KickLogz API search does not accept saved list identifiers.

customer_api_search_account_concurrent_limit HTTP 429

Too many active KickLogz API search jobs for this account.

The account already has the maximum number of outstanding search jobs.

customer_api_search_concurrent_limit HTTP 429

Too many active KickLogz API search jobs for this API key.

The key already has the maximum number of outstanding search jobs.

customer_api_search_queue_busy HTTP 429

KickLogz API search queue is temporarily busy. Please retry shortly.

The shared search queue is at capacity.

customer_api_search_job_id_required HTTP 400

jobId is required.

The search status endpoint needs a job identifier.

customer_api_search_job_not_found HTTP 404

Search job not found.

The job ID does not exist, expired, or belongs to another account.

customer_api_search_job_not_owned_by_key HTTP 403

This search job belongs to a different API key.

Only the originating API key can read a job result.

Veri çözümleme 13

streamer_not_found HTTP 404

Streamer not found.

The supplied streamer slug could not be resolved.

streamer_chatroom_not_found HTTP 404

Streamer chatroom not found.

The streamer exists, but a chatroom identifier is not available.

streamer_channel_not_found HTTP 404

Streamer channel not found.

The streamer exists, but a channel identifier is not available.

prediction_id_required HTTP 400

Prediction ID is required.

A prediction identifier must be supplied in the path.

prediction_not_found HTTP 404

Prediction not found.

The prediction ID could not be resolved to a known prediction.

broadcast_not_found HTTP 404

Broadcast not found.

The broadcast identifier could not be resolved.

customer_api_broadcast_window_invalid HTTP 400

Yayın tarih aralığı kullanılamıyor.

Yayın mevcut, ancak kullanılabilir başlangıç/bitiş sınırları eksik veya geçersiz.

customer_api_audience_scope_invalid HTTP 400

İzleyici sohbetçi kapsamı geçersiz.

İstenen izleyici kapsamında chatroom veya geçerli tarih sınırları eksik.

customer_api_audience_period_invalid HTTP 400

İzleyici dönemi geçersiz.

Audience authenticity jobları sabit yakın dönemleri veya sınırlandırılmış özel tarih aralığını destekler.

customer_api_audience_job_not_found HTTP 404

Audience authenticity job bulunamadı.

Job ID mevcut değil veya başka bir hesaba ait.

customer_api_audience_snapshot_not_found HTTP 404

Audience authenticity skoru bulunamadı.

İstenen kapsam için tamamlanmış audience authenticity snapshotı henüz yok.

customer_api_clickhouse_unavailable HTTP 500

ClickHouse client is not available.

The analytics datastore is unavailable for the request.

customer_api_internal_error HTTP 500

Unexpected KickLogz API error.

Fallback internal error for unexpected failures.

Endpoint gezgini

Tüm endpoint kataloğunda ara

Endpoint kodu, method, path, aile veya açıklamaya göre ara.

Yayıncı profilleri

Salt okunur yayıncı profil, sohbet, abonelik ve analitik endpoint'leri.

33/33 Canlıda

GET

streamer.summary

Streamer summary

/api/customer/v1/streamers/:slug

Canlıda 1 units Yayıncı kapsamlı

Resolves a streamer slug into core profile context plus 30-day message totals.

Use this as the root record for streamer-level analytics dashboards.

GET /api/customer/v1/streamers/:slug

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z",
    "chatroom_id": 90500123,
    "channel_id": 50291333,
    "message_count": 183245,
    "message_count_30d": 183245
  }
}

Hata kodları 12 olası hata

GET

streamer.users

Unique chatters

/api/customer/v1/streamers/:slug/users

Canlıda 1 units Yayıncı kapsamlı

Counts distinct users who sent at least one message during the last 30 days.

Good for DAU-style streamer activity analysis.

GET /api/customer/v1/streamers/:slug/users

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/users" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "uniqueUsers": 12453
}

Hata kodları 13 olası hata

GET

streamer.audience_chatters

Yayıncı izleyici sohbetçileri

/api/customer/v1/streamers/:slug/audience-chatters

Canlıda 5 units Yayıncı kapsamlı

Belirli bir yayıncı dönemi için sohbetçileri hesap yaşı, takip yaşı ve çapraz kanal aktivitesiyle listeler.

Bunu audience authenticity skoru için hazır izleyici listesi olarak kullanın. Ham sohbet geçmişini tamamen taramak yerine cache Kick profil/takip verileri ve user_day_channel_messages aggregate verilerini kullanır.

GET /api/customer/v1/streamers/:slug/audience-chatters

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

period

Query

string

Opsiyonel

dateFrom/dateTo verilmediğinde kullanılacak dönem: last_24h veya last_7d.

last_7d

dateFrom

Query

ISO 8601 datetime

Opsiyonel

Özel dahil başlangıç zamanı. Plan tarih aralığı limitine uymalıdır.

2026-03-17T00:00:00.000Z

dateTo

Query

ISO 8601 datetime

Opsiyonel

Özel hariç bitiş zamanı. Plan tarih aralığı limitine uymalıdır.

2026-03-18T00:00:00.000Z

categoryScope

Query

string

Opsiyonel

Global çapraz kanal aktivitesi için all, Slots & Casino aggregate çapraz kanal aktivitesi için slots_casino kullanın.

slots_casino

category

Query

string

Opsiyonel

Aggregate kategori çapraz kanal aktivitesi için opsiyonel özel kategori adı.

Slots & Casino

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/audience-chatters?page=1&limit=20&period=last_7d&categoryScope=slots_casino" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "scope": {
    "type": "streamer_period",
    "dateFrom": "2026-03-10T17:00:00.000Z",
    "dateTo": "2026-03-17T17:00:00.000Z",
    "period": "last_7d",
    "streamer": {
      "slug": "semm_usa",
      "profilepic": "https://kicklogz.com/images/logo.png",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "updatedAt": "2026-03-22T02:14:00.000Z"
    }
  },
  "categoryScope": {
    "requested": "slots_casino",
    "applied": true,
    "categories": [
      "slots & casino",
      "slots",
      "casino",
      "casino & slots"
    ],
    "method": "user_day_channel_messages filtered by stream_metadata_changes category history"
  },
  "enrichment": {
    "kick_profile_cache": "postgres_cache_only",
    "channel_user_cache": "postgres_cache_only",
    "live_kick_fetch": false,
    "note": "Missing or 404 follow/profile cache rows mean unknown status, not bot evidence."
  },
  "data": [
    {
      "user_id": 998811,
      "username": "viewer42",
      "slug": "viewer42",
      "message_count": 84,
      "unique_message_count": 31,
      "repeated_message_count": 53,
      "repeated_message_share": 0.631,
      "emote_only_message_count": 12,
      "emote_only_message_share": 0.1429,
      "first_message_at": "2026-03-17T17:08:00.000Z",
      "last_message_at": "2026-03-17T20:55:00.000Z",
      "kick_profile": {
        "cache_status": "hit",
        "kick_user_id": 998811,
        "account_created_at": "2024-11-21T12:00:00.000Z",
        "account_age_days": 482,
        "account_age_source": "user.created_at",
        "email_verified_at": null,
        "checked_at": "2026-05-21T18:00:00.000Z",
        "last_error": null
      },
      "channel_relationship": {
        "cache_status": "hit",
        "following_since": "2025-04-13T23:16:39.000Z",
        "follow_age_days": 338,
        "subscribed_for": 0,
        "is_staff": false,
        "is_channel_owner": false,
        "is_moderator": false,
        "badges": [],
        "banned": null,
        "checked_at": "2026-05-21T18:00:00.000Z",
        "last_error": null
      },
      "cross_channel": {
        "first_seen_date": "2025-01-04",
        "last_seen_date": "2026-05-21",
        "all_time_channels": 14,
        "all_time_other_channels": 13,
        "all_time_messages": 4021,
        "window_channels": 3,
        "window_other_channels": 2,
        "window_messages": 211
      },
      "category_cross_channel": {
        "first_seen_date": "2025-02-01",
        "last_seen_date": "2026-05-21",
        "all_time_channels": 4,
        "all_time_other_channels": 3,
        "all_time_messages": 920,
        "window_channels": 2,
        "window_other_channels": 1,
        "window_messages": 68
      }
    }
  ],
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalItems": 1260,
  "totalPages": 63
}

Hata kodları 17 olası hata

GET

streamer.emotes

Emote usage total

/api/customer/v1/streamers/:slug/emotes

Canlıda 1 units Yayıncı kapsamlı

Counts messages containing emotes during the last 30 days.

Returns a fast single-number aggregate for emote-heavy channels.

GET /api/customer/v1/streamers/:slug/emotes

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/emotes" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "totalEmotes": 28811
}

Hata kodları 13 olası hata

GET

streamer.first_message

First tracked message

/api/customer/v1/streamers/:slug/first-message

Canlıda 1 units Yayıncı kapsamlı

Returns the earliest tracked chat message timestamp for the streamer.

Helpful when you want to know how far historical chat coverage goes for a channel.

GET /api/customer/v1/streamers/:slug/first-message

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/first-message" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "firstMessageDate": "2024-02-02T18:30:00.000Z"
}

Hata kodları 13 olası hata

GET

streamer.messages

Latest chat messages

/api/customer/v1/streamers/:slug/messages

Canlıda 5 units Yayıncı kapsamlı

Returns the most recent tracked chat messages for the streamer.

The endpoint is read-only and intended for recent chat previews or lightweight export tasks. You can request up to 250 recent messages in one call.

GET /api/customer/v1/streamers/:slug/messages

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

limit

Query

integer

Opsiyonel

Maximum number of recent chat rows to return. Minimum 1, maximum 250.

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/messages?limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "messages": [
    {
      "id": "1827107192312",
      "user_id": 998811,
      "username": "viewer42",
      "slug": "semm_usa",
      "color": "#53FC18",
      "content": "gg wp",
      "created_at": "2026-03-21T21:20:11.000Z",
      "created_at_formatted": "2026-03-21T21:20:11.000Z"
    }
  ]
}

Hata kodları 14 olası hata

GET

streamer.hourly_activity

Hourly activity chart

/api/customer/v1/streamers/:slug/charts/hourly-activity

Canlıda 2 units Yayıncı kapsamlı

Returns 24 hourly buckets for recent streamer chat activity.

Useful for understanding which hours generate the most chat volume.

GET /api/customer/v1/streamers/:slug/charts/hourly-activity

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/charts/hourly-activity" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "labels": [
    "00:00",
    "01:00",
    "02:00",
    "03:00"
  ],
  "data": [
    184,
    97,
    65,
    41
  ]
}

Hata kodları 13 olası hata

GET

streamer.popular_categories

Popular categories

/api/customer/v1/streamers/:slug/charts/popular-categories

Canlıda 2 units Yayıncı kapsamlı

Returns the top categories by broadcast time in the last 30 days.

Category duration is aggregated across finished and currently live broadcasts.

GET /api/customer/v1/streamers/:slug/charts/popular-categories

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/charts/popular-categories" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "category_name": "Just Chatting",
      "broadcast_count": 4,
      "total_hours": 12.5
    },
    {
      "category_name": "Slots",
      "broadcast_count": 2,
      "total_hours": 5.25
    }
  ]
}

Hata kodları 12 olası hata

GET

streamer.popular_emotes

Popular emotes

/api/customer/v1/streamers/:slug/charts/popular-emotes

Canlıda 2 units Yayıncı kapsamlı

Returns emote labels and usage counts for the last 30 days.

Chart-friendly output with parallel labels and data arrays.

GET /api/customer/v1/streamers/:slug/charts/popular-emotes

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/charts/popular-emotes" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "labels": [
    "Pog",
    "LUL",
    "W"
  ],
  "data": [
    842,
    621,
    388
  ]
}

Hata kodları 13 olası hata

GET

streamer.daily_trend

Daily trend

/api/customer/v1/streamers/:slug/charts/daily-trend

Canlıda 2 units Yayıncı kapsamlı

Returns daily message totals for the recent trend window.

Good for plotting momentum and day-over-day streamer engagement.

GET /api/customer/v1/streamers/:slug/charts/daily-trend

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/charts/daily-trend" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "labels": [
    "2026-03-16",
    "2026-03-17",
    "2026-03-18",
    "2026-03-19"
  ],
  "data": [
    1820,
    2103,
    1931,
    2218
  ]
}

Hata kodları 13 olası hata

GET

streamer.active_users

Most active chatters

/api/customer/v1/streamers/:slug/charts/active-users

Canlıda 2 units Yayıncı kapsamlı

Returns the top usernames by message count for the recent window.

This endpoint is useful for leaderboard widgets or moderation dashboards.

GET /api/customer/v1/streamers/:slug/charts/active-users

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/charts/active-users?limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "labels": [
    "viewer42",
    "viewer77",
    "viewer99"
  ],
  "data": [
    321,
    207,
    188
  ]
}

Hata kodları 14 olası hata

GET

streamer.room_settings

Room settings history

/api/customer/v1/streamers/:slug/room-settings

Canlıda 2 units Yayıncı kapsamlı

Returns the tracked moderation and room configuration history for the streamer chat.

Useful for auditing how room restrictions changed over time.

GET /api/customer/v1/streamers/:slug/room-settings

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/room-settings" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "totalRoomSettings": 3,
  "roomSettings": [
    {
      "setting_type": "slow_mode",
      "enabled": true,
      "value": 10,
      "changed_by_username": "mod_jane",
      "created_at": "2026-03-19T15:00:00.000Z"
    }
  ]
}

Hata kodları 13 olası hata

GET

streamer.subscriptions_summary

Subscription summary

/api/customer/v1/streamers/:slug/subscriptions

Canlıda 2 units Yayıncı kapsamlı

Returns 30-day subscriber totals, latest normal/gifted subscribers, and top gifters.

Designed for overview cards without requiring multiple paginated calls.

GET /api/customer/v1/streamers/:slug/subscriptions

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/subscriptions?limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "totalSubscribers": {
    "normal": 124,
    "gifted": 37,
    "total": 161
  },
  "normalSubscribers": [
    {
      "username": "viewer42",
      "months": 3,
      "tier": "Tier 1",
      "event_time": "2026-03-20T19:00:00.000Z",
      "is_renewed": true
    }
  ],
  "giftedSubscribers": [
    {
      "username": "viewer77",
      "months": 1,
      "tier": "Tier 1",
      "gifter_username": "biggifter",
      "event_time": "2026-03-20T20:00:00.000Z",
      "is_renewed": false
    }
  ],
  "topGifters": [
    {
      "gifter_username": "biggifter",
      "total_gifts": 14
    }
  ]
}

Hata kodları 14 olası hata

GET

streamer.subscriptions_normal

Normal subscribers

/api/customer/v1/streamers/:slug/subscriptions/normal

Canlıda 3 units Yayıncı kapsamlı

Returns paginated normal subscribers for the last 30 days.

Each record represents the latest known subscription state per username.

GET /api/customer/v1/streamers/:slug/subscriptions/normal

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/subscriptions/normal?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "username": "viewer42",
      "months": 3,
      "tier": "Tier 1",
      "event_time": "2026-03-20T19:00:00.000Z",
      "is_renewed": true
    }
  ],
  "totalItems": 124,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 7
}

Hata kodları 14 olası hata

GET

streamer.subscriptions_gifted

Gifted subscribers

/api/customer/v1/streamers/:slug/subscriptions/gifted

Canlıda 3 units Yayıncı kapsamlı

Returns paginated gifted subscription events for the last 30 days.

Records include the gifting username when present.

GET /api/customer/v1/streamers/:slug/subscriptions/gifted

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/subscriptions/gifted?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "username": "viewer77",
      "months": 1,
      "tier": "Tier 1",
      "gifter_username": "biggifter",
      "event_time": "2026-03-20T20:00:00.000Z",
      "is_renewed": false
    }
  ],
  "totalItems": 37,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 2
}

Hata kodları 14 olası hata

GET

streamer.subscriptions_top_gifters

Top gifters

/api/customer/v1/streamers/:slug/subscriptions/top-gifters

Canlıda 3 units Yayıncı kapsamlı

Returns paginated top gifters ranked by gift count.

Good for sponsor, community, or monetization dashboards.

GET /api/customer/v1/streamers/:slug/subscriptions/top-gifters

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/subscriptions/top-gifters?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "gifter_username": "biggifter",
      "total_gifts": 14,
      "last_gift_date": "2026-03-20T20:00:00.000Z"
    }
  ],
  "totalItems": 9,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.gifts_latest

Latest gifts

/api/customer/v1/streamers/:channelId/gifts/latest

Canlıda 3 units

Returns paginated latest Kick gifts for a channel ID.

This endpoint uses channelId instead of slug because gifts are channel-level events.

GET /api/customer/v1/streamers/:channelId/gifts/latest

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

channelId

Path

integer

Zorunlu

Kick channel ID for the streamer.

50291333

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/50291333/gifts/latest?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "sender_username": "viewer42",
      "gift_name": "Rocket",
      "gift_amount": 5,
      "message": "LFG",
      "event_time": "2026-03-20T20:10:00.000Z"
    }
  ],
  "totalItems": 57,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 3
}

Hata kodları 13 olası hata

GET

streamer.gifts_total

Gift total

/api/customer/v1/streamers/:channelId/gifts/total

Canlıda 1 units

Returns the total gift amount tracked in the last 30 days for the channel.

A compact metric endpoint for monetization summaries.

GET /api/customer/v1/streamers/:channelId/gifts/total

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

channelId

Path

integer

Zorunlu

Kick channel ID for the streamer.

50291333

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/50291333/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "total_gifts": 241
}

Hata kodları 12 olası hata

GET

streamer.bans

Ban history

/api/customer/v1/streamers/:slug/bans

Canlıda 3 units Yayıncı kapsamlı

Returns paginated ban events for the last 30 days.

Useful for moderation review, abuse dashboards, or safety analytics.

GET /api/customer/v1/streamers/:slug/bans

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/bans?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "id": "ban_1202",
      "user_id": 442211,
      "username": "toxic_user",
      "slug": "semm_usa",
      "banned_by_id": 7711,
      "banned_by_username": "mod_jane",
      "banned_by_slug": "mod_jane",
      "permanent": false,
      "created_at": "2026-03-18T22:00:00.000Z",
      "expires_at": "2026-03-19T22:00:00.000Z",
      "unbanned_at": null,
      "unbanned_by_id": null,
      "unbanned_by_username": null,
      "unbanned_by_slug": null
    }
  ],
  "totalItems": 13,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.top_moderators

Top moderators

/api/customer/v1/streamers/:slug/top-moderators

Canlıda 2 units Yayıncı kapsamlı

Returns moderators ranked by recorded ban activity.

A lightweight aggregate endpoint for moderation leaderboards.

GET /api/customer/v1/streamers/:slug/top-moderators

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/top-moderators?limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "moderators": [
    {
      "banned_by_username": "mod_jane",
      "ban_count": 24
    }
  ]
}

Hata kodları 14 olası hata

GET

streamer.hosts

Hosts history

/api/customer/v1/streamers/:slug/hosts

Canlıda 3 units Yayıncı kapsamlı

Returns paginated host/raid style events.

Each row includes the host username, viewer count, and optional message.

GET /api/customer/v1/streamers/:slug/hosts

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/hosts?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "host_username": "partner_channel",
      "number_viewers": 213,
      "optional_message": "raid time",
      "created_at": "2026-03-19T23:35:00.000Z"
    }
  ],
  "totalItems": 8,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.polls

Poll history

/api/customer/v1/streamers/:slug/polls

Canlıda 3 units Yayıncı kapsamlı

Returns paginated streamer polls from the recent 30-day window.

Poll options are returned as parsed JSON when available.

GET /api/customer/v1/streamers/:slug/polls

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/polls?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "id": 1099,
      "title": "Next game?",
      "options": [
        {
          "label": "Valorant",
          "votes": 342
        },
        {
          "label": "CS2",
          "votes": 201
        }
      ],
      "duration": 120,
      "created_at": "2026-03-19T23:40:00.000Z"
    }
  ],
  "totalItems": 6,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.predictions

Prediction summaries

/api/customer/v1/streamers/:slug/predictions

Canlıda 3 units Yayıncı kapsamlı

Returns paginated prediction summaries for the streamer channel.

Use the predictionId from this endpoint to read full event history.

GET /api/customer/v1/streamers/:slug/predictions

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/predictions?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "prediction_id": "pred_1177001",
      "title": "Will we hit top 10?",
      "outcomes": [
        {
          "id": "1",
          "title": "Yes",
          "points": 4500
        },
        {
          "id": "2",
          "title": "No",
          "points": 1200
        }
      ],
      "state": "resolved",
      "winning_outcome_id": "1",
      "duration_seconds": 300,
      "created_at": "2026-03-19T23:41:00.000Z",
      "locked_at": "2026-03-19T23:46:00.000Z",
      "updated_at": "2026-03-19T23:47:00.000Z"
    }
  ],
  "totalItems": 11,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.prediction_history

Prediction history

/api/customer/v1/predictions/:predictionId/history

Canlıda 3 units

Returns the full ordered event history for a single prediction.

Useful when you need lifecycle detail such as creation, locking, updates, and resolution.

GET /api/customer/v1/predictions/:predictionId/history

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

predictionId

Path

string

Zorunlu

Prediction identifier returned by prediction endpoints.

pred_1177001

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/predictions/pred_1177001/history" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "predictionId": "pred_1177001",
  "history": [
    {
      "event_type": "prediction.updated",
      "prediction_id": "pred_1177001",
      "title": "Will we hit top 10?",
      "state": "locked",
      "duration_seconds": 300,
      "created_at": "2026-03-19T23:41:00.000Z",
      "locked_at": "2026-03-19T23:46:00.000Z",
      "winning_outcome_id": null,
      "updated_at": "2026-03-19T23:46:00.000Z",
      "outcomes": [
        {
          "id": "1",
          "title": "Yes",
          "points": 3900
        },
        {
          "id": "2",
          "title": "No",
          "points": 1100
        }
      ]
    }
  ]
}

Hata kodları 13 olası hata

GET

streamer.pinned_messages

Pinned messages

/api/customer/v1/streamers/:slug/pinned-messages

Canlıda 3 units Yayıncı kapsamlı

Returns paginated pinned message history.

Rows include sender, moderator, duration, and deletion timestamp when available.

GET /api/customer/v1/streamers/:slug/pinned-messages

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/pinned-messages?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "id": 913,
      "sender_username": "viewer42",
      "content": "Huge win!",
      "pinned_by_username": "mod_jane",
      "duration": 120,
      "created_at": "2026-03-18T21:10:00.000Z",
      "deleted_at": null
    }
  ],
  "totalItems": 15,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 14 olası hata

GET

streamer.reward_stats

Reward stats

/api/customer/v1/streamers/:slug/reward-stats

Canlıda 3 units Yayıncı kapsamlı

Returns top redeemers plus reward redemption pagination blocks.

Includes both raw reward redemptions and a separate leaderboard for top rewards.

GET /api/customer/v1/streamers/:slug/reward-stats

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/reward-stats?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "totalRedemptions": 128,
  "topRedeemer": {
    "username": "viewer42",
    "count": 14
  },
  "rewardsPagination": {
    "data": [
      {
        "username": "viewer42",
        "reward_title": "Hydrate",
        "reward_cost": 200,
        "redeemed_at": "2026-03-17T20:02:00.000Z"
      }
    ],
    "totalItems": 128,
    "currentPage": 1,
    "itemsPerPage": 10,
    "totalPages": 13
  },
  "topRewards": {
    "data": [
      {
        "title": "Hydrate",
        "count": 42
      },
      {
        "title": "Stand up",
        "count": 18
      }
    ],
    "totalItems": 9,
    "currentPage": 1,
    "itemsPerPage": 10,
    "totalPages": 1
  }
}

Hata kodları 14 olası hata

GET

streamer.broadcasts

Broadcast history

/api/customer/v1/streamers/:slug/broadcasts

Canlıda 3 units Yayıncı kapsamlı

Returns paginated broadcasts for the streamer with optional title/date filtering.

Supports pagination plus optional search, startDate, and endDate query filters.

GET /api/customer/v1/streamers/:slug/broadcasts

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

search

Query

string

Opsiyonel

Case-insensitive title or slug filter.

ranked

startDate

Query

date

Opsiyonel

Inclusive broadcast start date filter.

2026-03-01

endDate

Query

date

Opsiyonel

Inclusive broadcast end date filter.

2026-03-22

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/broadcasts?page=1&limit=20&search=ranked&startDate=2026-03-01&endDate=2026-03-22" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "id": "892112233",
      "channel_id": 50291333,
      "title": "Ranked grind",
      "started_at": "2026-03-17T17:00:00.000Z",
      "ended_at": "2026-03-17T21:02:00.000Z",
      "is_live": false,
      "slug": "semm_usa",
      "duration_seconds": 14520,
      "clip_count": 18
    }
  ],
  "totalItems": 12,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 15 olası hata

POST

streamer.audience_authenticity_job_create

Yayıncı audience authenticity skorunu sıraya al

/api/customer/v1/streamers/:slug/audience-authenticity/jobs

Canlıda 8 units Yayıncı kapsamlı

Bir yayıncı dönemi için asenkron audience authenticity skoru oluşturur.

Sohbet içeriği, hesap yaşı, takip yaşı, çapraz kanal aktivitesi ve izleyici/sohbet uyumunu birleştirir. forceRefresh yoksa mevcut snapshot tekrar kullanılır.

POST /api/customer/v1/streamers/:slug/audience-authenticity/jobs

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Content-Type

string

Zorunlu

Required for JSON request bodies.

application/json

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

period

Body

string

Opsiyonel

Kapsam ön ayarı: uygun olduğunda last_broadcast, last_7d veya last_30d.

last_7d

dateFrom

Body

ISO 8601 datetime

Opsiyonel

Özel dahil başlangıç zamanı. dateTo ile birlikte gönderilmelidir.

2026-03-17T00:00:00.000Z

dateTo

Body

ISO 8601 datetime

Opsiyonel

Özel hariç bitiş zamanı. dateFrom ile birlikte gönderilmelidir.

2026-03-18T00:00:00.000Z

forceRefresh

Body

boolean

Opsiyonel

true ise tekrar kullanılabilir tamamlanmış snapshot atlanır ve yeni skor sıraya alınır.

false

Örnek istek bash

curl -X POST "https://kicklogz.com/api/customer/v1/streamers/semm_usa/audience-authenticity/jobs" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{
  "period": "last_7d"
}'

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "status": "queued",
  "jobId": "3d8f8930-6222-4d7c-9d64-936cbe0c3510",
  "reusedJob": false,
  "snapshotId": null,
  "scope": {
    "scopeType": "streamer_period",
    "streamerSlug": "semm_usa",
    "periodKey": "last_7d"
  },
  "queuedAt": "2026-05-21T18:05:00.000Z"
}

Hata kodları 16 olası hata

GET

streamer.audience_authenticity_latest

Son yayıncı audience authenticity skoru

/api/customer/v1/streamers/:slug/audience-authenticity/latest

Canlıda 2 units Yayıncı kapsamlı

Yayıncı kapsamı için tamamlanmış son audience authenticity snapshotını döndürür.

Skor sıraya alındıktan sonra veya aynı dönem/tarih aralığı için son kullanılabilir snapshotı okumak için kullanılır.

GET /api/customer/v1/streamers/:slug/audience-authenticity/latest

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

period

Query

string

Opsiyonel

Preset scope matching the queued job.

last_7d

dateFrom

Query

ISO 8601 datetime

Opsiyonel

Custom inclusive start timestamp matching the queued job. Provide together with dateTo.

2026-03-17T00:00:00.000Z

dateTo

Query

ISO 8601 datetime

Opsiyonel

Custom exclusive end timestamp matching the queued job. Provide together with dateFrom.

2026-03-18T00:00:00.000Z

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/audience-authenticity/latest?period=last_7d" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "status": "completed",
  "reusedSnapshot": true,
  "snapshotId": "9d22ad34-a4be-444d-922d-7cb0be011567",
  "generatedAt": "2026-05-21T18:10:00.000Z",
  "result": {
    "schemaVersion": "customer_api_audience_authenticity_v1",
    "generatedAt": "2026-05-21T18:10:00.000Z",
    "scope": {
      "scopeType": "broadcast",
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "dateFrom": "2026-03-17T17:00:00.000Z",
      "dateTo": "2026-03-17T21:02:00.000Z"
    },
    "scores": {
      "authenticityScore": 91.4,
      "suspicionScore": 8.6,
      "confidenceScore": 76.2,
      "confidenceBand": "high"
    },
    "summary": {
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "totalMessages": 18324,
      "uniqueChatters": 1260,
      "avgViewers": 18420,
      "peakViewers": 24112
    },
    "signals": {
      "emoteOnlyMessageShare": 0.18,
      "repeatedMessageRatio": 0.12,
      "singleChannelChatterShare": 0.22,
      "newKickAccountShare": 0.03,
      "newFollowerShare7d": 0.04,
      "newFollowerShare30d": 0.08
    },
    "explanation": {
      "headline": "Audience signals look mostly organic within the available data.",
      "limitations": [
        "Silent viewers cannot be identified directly.",
        "404/unknown Kick follow lookups are treated as unknown status, not bot evidence."
      ]
    }
  }
}

Hata kodları 16 olası hata

GET

streamer.audience_authenticity_status

Yayıncı audience authenticity durumu

/api/customer/v1/streamers/:slug/audience-authenticity/status

Canlıda 1 units Yayıncı kapsamlı

Bir yayıncı kapsamı için audience authenticity skorunun hazır olup olmadığını kontrol eder.

JobId saklamadan yayıncı kapsamını poll etmek için kullanılır. ready true ise üretilen result döner; değilse aynı scope için son queued/running/failed job durumu döner.

GET /api/customer/v1/streamers/:slug/audience-authenticity/status

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

period

Query

string

Opsiyonel

Preset scope matching the queued job.

last_7d

dateFrom

Query

ISO 8601 datetime

Opsiyonel

Custom inclusive start timestamp matching the queued job. Provide together with dateTo.

2026-03-17T00:00:00.000Z

dateTo

Query

ISO 8601 datetime

Opsiyonel

Custom exclusive end timestamp matching the queued job. Provide together with dateFrom.

2026-03-18T00:00:00.000Z

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/audience-authenticity/status?period=last_7d" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "ready": true,
  "status": "completed",
  "snapshotId": "9d22ad34-a4be-444d-922d-7cb0be011567",
  "generatedAt": "2026-05-21T18:10:00.000Z",
  "scope": {
    "scopeType": "broadcast",
    "streamerSlug": "semm_usa",
    "broadcastId": 892112233,
    "dateFrom": "2026-03-17T17:00:00.000Z",
    "dateTo": "2026-03-17T21:02:00.000Z"
  },
  "result": {
    "schemaVersion": "customer_api_audience_authenticity_v1",
    "generatedAt": "2026-05-21T18:10:00.000Z",
    "scope": {
      "scopeType": "broadcast",
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "dateFrom": "2026-03-17T17:00:00.000Z",
      "dateTo": "2026-03-17T21:02:00.000Z"
    },
    "scores": {
      "authenticityScore": 91.4,
      "suspicionScore": 8.6,
      "confidenceScore": 76.2,
      "confidenceBand": "high"
    },
    "summary": {
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "totalMessages": 18324,
      "uniqueChatters": 1260,
      "avgViewers": 18420,
      "peakViewers": 24112
    },
    "signals": {
      "emoteOnlyMessageShare": 0.18,
      "repeatedMessageRatio": 0.12,
      "singleChannelChatterShare": 0.22,
      "newKickAccountShare": 0.03,
      "newFollowerShare7d": 0.04,
      "newFollowerShare30d": 0.08
    },
    "explanation": {
      "headline": "Audience signals look mostly organic within the available data.",
      "limitations": [
        "Silent viewers cannot be identified directly.",
        "404/unknown Kick follow lookups are treated as unknown status, not bot evidence."
      ]
    }
  },
  "paths": {
    "latest": "/streamers/semm_usa/audience-authenticity/latest",
    "createJob": "/streamers/semm_usa/audience-authenticity/jobs"
  }
}

Hata kodları 16 olası hata

GET

streamer.audience_authenticity_job_status

Audience authenticity job durumu

/api/customer/v1/audience-authenticity/jobs/:jobId

Canlıda 1 units

Audience authenticity job için queued/running/completed/failed durumunu okur.

Yayıncı veya yayın skoru oluşturduktan sonra bu endpointi poll edin. Tamamlanan joblar sonuç payloadını içerir.

GET /api/customer/v1/audience-authenticity/jobs/:jobId

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

jobId

Path

string

Zorunlu

Job ID returned by an asynchronous Customer API endpoint.

customer-api-search-123e4567-e89b-12d3-a456-426614174000

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/audience-authenticity/jobs/customer-api-search-123e4567-e89b-12d3-a456-426614174000" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "status": "completed",
  "jobId": "customer-api-search-123e4567-e89b-12d3-a456-426614174000",
  "reusedJob": false,
  "snapshotId": "9d22ad34-a4be-444d-922d-7cb0be011567",
  "scope": {
    "scopeType": "broadcast",
    "streamerSlug": "semm_usa",
    "broadcastId": 892112233
  },
  "queuedAt": "2026-05-21T18:05:00.000Z",
  "completedAt": "2026-05-21T18:10:00.000Z",
  "error": null,
  "result": {
    "schemaVersion": "customer_api_audience_authenticity_v1",
    "generatedAt": "2026-05-21T18:10:00.000Z",
    "scope": {
      "scopeType": "broadcast",
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "dateFrom": "2026-03-17T17:00:00.000Z",
      "dateTo": "2026-03-17T21:02:00.000Z"
    },
    "scores": {
      "authenticityScore": 91.4,
      "suspicionScore": 8.6,
      "confidenceScore": 76.2,
      "confidenceBand": "high"
    },
    "summary": {
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "totalMessages": 18324,
      "uniqueChatters": 1260,
      "avgViewers": 18420,
      "peakViewers": 24112
    },
    "signals": {
      "emoteOnlyMessageShare": 0.18,
      "repeatedMessageRatio": 0.12,
      "singleChannelChatterShare": 0.22,
      "newKickAccountShare": 0.03,
      "newFollowerShare7d": 0.04,
      "newFollowerShare30d": 0.08
    },
    "explanation": {
      "headline": "Audience signals look mostly organic within the available data.",
      "limitations": [
        "Silent viewers cannot be identified directly.",
        "404/unknown Kick follow lookups are treated as unknown status, not bot evidence."
      ]
    }
  }
}

Hata kodları 10 olası hata

GET

streamer.clips

Clips

/api/customer/v1/streamers/:slug/clips

Canlıda 3 units Yayıncı kapsamlı

Returns paginated clips for the streamer channel.

Includes clip URLs, thumbnails, duration, views, and creator metadata.

GET /api/customer/v1/streamers/:slug/clips

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

slug

Path

string

Zorunlu

Streamer slug assigned to the account or API key.

semm_usa

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/clips?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "id": 4411,
      "title": "Clutch moment",
      "clip_url": "https://kick.com/clip/4411",
      "thumbnail_url": "https://kicklogz.com/images/logo.png",
      "duration_seconds": 28,
      "views": 5230,
      "created_at": "2026-03-18T02:33:00.000Z",
      "creator_username": "viewer42",
      "channel_username": "semm_usa",
      "livestream_id": "892112233"
    }
  ],
  "totalItems": 31,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 2
}

Hata kodları 13 olası hata

GET

streamer.similar

Similar streamers

/api/customer/v1/streamers/:chatroomId/similar

Canlıda 4 units

Returns a list of streamers similar to the supplied chatroom.

Useful for recommendation widgets or competitor discovery.

GET /api/customer/v1/streamers/:chatroomId/similar

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

chatroomId

Path

integer

Zorunlu

Kick chatroom ID for the streamer.

90500123

limit

Query

integer

Opsiyonel

Maximum similar streamers to return.

6

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/streamers/90500123/similar?limit=6" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "streamer": {
    "slug": "semm_usa",
    "profilepic": "https://kicklogz.com/images/logo.png",
    "chatroomId": 90500123,
    "channelId": 50291333,
    "language": "en",
    "updatedAt": "2026-03-22T02:14:00.000Z"
  },
  "data": [
    {
      "chatroom_id": 80555111,
      "common_subscribers_count": 842,
      "common_subscriber_percentage": 18.4,
      "slug": "another_streamer",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  ]
}

Hata kodları 13 olası hata

Yayın analitiği

Yayın kapsamlı analitik, aktivite, hediye ve klip endpoint'leri.

17/17 Canlıda

GET

broadcast.stats

Broadcast stats

/api/customer/v1/broadcasts/:broadcastId/stats

Canlıda 4 units

Returns the main analytics snapshot for a single broadcast window.

Useful for per-stream recaps, retention analysis, and replay dashboards that need message and viewer curves on one payload.

GET /api/customer/v1/broadcasts/:broadcastId/stats

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/stats" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "duration_seconds": 14520,
  "duration_formatted": "4h 2m",
  "chat_message_count": 18324,
  "average_viewers": 18420,
  "peak_viewers": 24112,
  "uniqueChattersPerSegment": [
    212,
    244,
    257,
    301,
    333,
    347,
    362,
    318,
    291,
    240
  ],
  "uniqueSubscriberChattersPerSegment": [
    41,
    49,
    55,
    62,
    70,
    73,
    76,
    65,
    58,
    47
  ],
  "uniqueNonSubscriberChattersPerSegment": [
    171,
    195,
    202,
    239,
    263,
    274,
    286,
    253,
    233,
    193
  ],
  "messagesPerSegment": [
    1204,
    1488,
    1612,
    1880,
    2107,
    2244,
    2350,
    2055,
    1874,
    1510
  ],
  "subscriberMessagesPerSegment": [
    310,
    344,
    361,
    401,
    438,
    466,
    479,
    428,
    391,
    311
  ],
  "nonSubscriberMessagesPerSegment": [
    894,
    1144,
    1251,
    1479,
    1669,
    1778,
    1871,
    1627,
    1483,
    1199
  ]
}

Hata kodları 10 olası hata

GET

broadcast.top_chatters

Broadcast top chatters

/api/customer/v1/broadcasts/:broadcastId/top-chatters

Canlıda 4 units

Returns the most active usernames inside a single broadcast.

Good for stream replay leaderboards or identifying standout chat participation in a fixed broadcast window.

GET /api/customer/v1/broadcasts/:broadcastId/top-chatters

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/top-chatters?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "username": "viewer42",
      "message_count": 84
    }
  ],
  "totalItems": 126,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 13
}

Hata kodları 11 olası hata

GET

broadcast.audience_chatters

Yayın izleyici sohbetçileri

/api/customer/v1/broadcasts/:broadcastId/audience-chatters

Canlıda 5 units

Tek bir yayındaki her sohbetçiyi hesap/takip cache verisi ve çapraz kanal aktivitesiyle listeler.

Seçilen yayındaki sohbetçileri döndürür; cache Kick profil/takip tarihleri ve user_day_channel_messages aggregate verileriyle birleştirir.

GET /api/customer/v1/broadcasts/:broadcastId/audience-chatters

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

categoryScope

Query

string

Opsiyonel

Global çapraz kanal aktivitesi için all, Slots & Casino aggregate çapraz kanal aktivitesi için slots_casino kullanın.

slots_casino

category

Query

string

Opsiyonel

Aggregate kategori çapraz kanal aktivitesi için opsiyonel özel kategori adı.

Slots & Casino

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/audience-chatters?page=1&limit=20&categoryScope=slots_casino" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "scope": {
    "type": "broadcast",
    "dateFrom": "2026-03-17T17:00:00.000Z",
    "dateTo": "2026-03-17T21:02:00.000Z",
    "period": null,
    "streamer": {
      "slug": "semm_usa",
      "profilepic": "https://kicklogz.com/images/logo.png",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "updatedAt": "2026-03-22T02:14:00.000Z"
    },
    "broadcast": {
      "broadcastId": 892112233,
      "livestreamId": 892112233,
      "channelId": 50291333,
      "isLive": false,
      "startTime": "2026-03-17T17:00:00.000Z",
      "endTime": "2026-03-17T21:02:00.000Z",
      "sessionTitle": "Ranked grind",
      "streamer": {
        "slug": "semm_usa",
        "chatroomId": 90500123,
        "channelId": 50291333,
        "language": "en",
        "profilepic": "https://kicklogz.com/images/logo.png"
      }
    }
  },
  "categoryScope": {
    "requested": "slots_casino",
    "applied": true,
    "categories": [
      "slots & casino",
      "slots",
      "casino",
      "casino & slots"
    ],
    "method": "user_day_channel_messages filtered by stream_metadata_changes category history"
  },
  "enrichment": {
    "kick_profile_cache": "postgres_cache_only",
    "channel_user_cache": "postgres_cache_only",
    "live_kick_fetch": false,
    "note": "Missing or 404 follow/profile cache rows mean unknown status, not bot evidence."
  },
  "data": [
    {
      "user_id": 998811,
      "username": "viewer42",
      "slug": "viewer42",
      "message_count": 84,
      "unique_message_count": 31,
      "repeated_message_count": 53,
      "repeated_message_share": 0.631,
      "emote_only_message_count": 12,
      "emote_only_message_share": 0.1429,
      "first_message_at": "2026-03-17T17:08:00.000Z",
      "last_message_at": "2026-03-17T20:55:00.000Z",
      "kick_profile": {
        "cache_status": "hit",
        "kick_user_id": 998811,
        "account_created_at": "2024-11-21T12:00:00.000Z",
        "account_age_days": 482,
        "account_age_source": "user.created_at",
        "email_verified_at": null,
        "checked_at": "2026-05-21T18:00:00.000Z",
        "last_error": null
      },
      "channel_relationship": {
        "cache_status": "hit",
        "following_since": "2025-04-13T23:16:39.000Z",
        "follow_age_days": 338,
        "subscribed_for": 0,
        "is_staff": false,
        "is_channel_owner": false,
        "is_moderator": false,
        "badges": [],
        "banned": null,
        "checked_at": "2026-05-21T18:00:00.000Z",
        "last_error": null
      },
      "cross_channel": {
        "first_seen_date": "2025-01-04",
        "last_seen_date": "2026-05-21",
        "all_time_channels": 14,
        "all_time_other_channels": 13,
        "all_time_messages": 4021,
        "window_channels": 3,
        "window_other_channels": 2,
        "window_messages": 211
      },
      "category_cross_channel": {
        "first_seen_date": "2025-02-01",
        "last_seen_date": "2026-05-21",
        "all_time_channels": 4,
        "all_time_other_channels": 3,
        "all_time_messages": 920,
        "window_channels": 2,
        "window_other_channels": 1,
        "window_messages": 68
      }
    }
  ],
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalItems": 1260,
  "totalPages": 63
}

Hata kodları 13 olası hata

GET

broadcast.keywords

Broadcast keywords

/api/customer/v1/broadcasts/:broadcastId/keywords

Canlıda 4 units

Returns the most repeated words or phrases from that broadcast chat window.

Designed for topic extraction, clip indexing, and recap generation on a single broadcast.

GET /api/customer/v1/broadcasts/:broadcastId/keywords

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/keywords?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "keyword": "gg",
      "count": 118,
      "unique_users": 73
    }
  ],
  "totalItems": 48,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 3
}

Hata kodları 11 olası hata

GET

broadcast.polls

Broadcast polls

/api/customer/v1/broadcasts/:broadcastId/polls

Canlıda 4 units

Returns poll events created during the selected broadcast.

Each row includes the title, parsed options, and timing metadata for the poll event.

GET /api/customer/v1/broadcasts/:broadcastId/polls

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/polls?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "id": 1099,
      "title": "Next game?",
      "options": [
        {
          "label": "Valorant",
          "votes": 342
        },
        {
          "label": "CS2",
          "votes": 201
        }
      ],
      "total_votes": 543,
      "duration": 120,
      "created_at": "2026-03-17T19:40:00.000Z"
    }
  ],
  "totalItems": 4,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.predictions

Broadcast predictions

/api/customer/v1/broadcasts/:broadcastId/predictions

Canlıda 4 units

Returns prediction events created during the broadcast.

Useful when you want prediction outcomes scoped to one stream instead of the full streamer lifetime.

GET /api/customer/v1/broadcasts/:broadcastId/predictions

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/predictions?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "prediction_id": "pred_1177001",
      "title": "Will we hit top 10?",
      "outcomes": [
        {
          "id": "1",
          "title": "Yes",
          "points": 4500
        },
        {
          "id": "2",
          "title": "No",
          "points": 1200
        }
      ],
      "state": "resolved",
      "created_at": "2026-03-17T19:50:00.000Z",
      "updated_at": "2026-03-17T19:55:00.000Z"
    }
  ],
  "totalItems": 2,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.bans

Broadcast bans

/api/customer/v1/broadcasts/:broadcastId/bans

Canlıda 4 units

Returns only the ban events that happened during the broadcast.

This helps moderation reviews focus on a single stream instead of the entire 30-day channel history.

GET /api/customer/v1/broadcasts/:broadcastId/bans

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/bans?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "username": "toxic_user",
      "banned_by_username": "mod_jane",
      "permanent": false,
      "created_at": "2026-03-17T18:21:00.000Z",
      "expires_at": "2026-03-17T19:21:00.000Z",
      "unbanned_at": null
    }
  ],
  "totalItems": 7,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.pinned_messages

Broadcast pinned messages

/api/customer/v1/broadcasts/:broadcastId/pinned-messages

Canlıda 4 units

Returns pinned chat messages created during that broadcast.

Useful for timeline reconstruction, moderation audits, or highlight extraction.

GET /api/customer/v1/broadcasts/:broadcastId/pinned-messages

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/pinned-messages?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "sender_username": "viewer42",
      "content": "Huge win!",
      "pinned_by_username": "mod_jane",
      "duration": 120,
      "created_at": "2026-03-17T20:10:00.000Z",
      "deleted_at": null
    }
  ],
  "totalItems": 3,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.hosts

Broadcast hosts

/api/customer/v1/broadcasts/:broadcastId/hosts

Canlıda 4 units

Returns host or raid style events that landed inside the broadcast time range.

Each row includes the source channel, viewer count, and optional host message.

GET /api/customer/v1/broadcasts/:broadcastId/hosts

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/hosts?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "host_username": "partner_channel",
      "number_viewers": 213,
      "optional_message": "raid time",
      "created_at": "2026-03-17T20:40:00.000Z"
    }
  ],
  "totalItems": 2,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.subscribers

Broadcast subscribers

/api/customer/v1/broadcasts/:broadcastId/subscribers

Canlıda 4 units

Returns subscription events that happened during the broadcast.

Use the optional type filter to narrow the list to normal, gifted, or all subscription events.

GET /api/customer/v1/broadcasts/:broadcastId/subscribers

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

type

Query

string

Opsiyonel

Subscriber filter for the broadcast scope: all, normal, or gifted.

all

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/subscribers?page=1&limit=20&type=all" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "username": "viewer42",
      "months": 1,
      "is_gifted": false,
      "gifter_username": null,
      "event_time": "2026-03-17T18:45:00.000Z"
    }
  ],
  "totalItems": 19,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 12 olası hata

GET

broadcast.top_gifters

Broadcast top gifters

/api/customer/v1/broadcasts/:broadcastId/top-gifters

Canlıda 4 units

Returns the top gifter leaderboard for a single broadcast.

This is stream-scoped gifting activity rather than lifetime or 30-day channel totals.

GET /api/customer/v1/broadcasts/:broadcastId/top-gifters

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/top-gifters?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "gifter_username": "biggifter",
      "total_gifts": 14,
      "last_gift_date": "2026-03-17T20:12:00.000Z"
    }
  ],
  "totalItems": 9,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 1
}

Hata kodları 11 olası hata

GET

broadcast.gifts_total

Broadcast gift total

/api/customer/v1/broadcasts/:broadcastId/gifts/total

Canlıda 2 units

Returns the total Kick gifts tracked during the broadcast window.

A compact monetization metric for stream summaries and revenue dashboards.

GET /api/customer/v1/broadcasts/:broadcastId/gifts/total

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "total_gifts": 241
}

Hata kodları 10 olası hata

GET

broadcast.gifts

Broadcast gifts

/api/customer/v1/broadcasts/:broadcastId/gifts

Canlıda 4 units

Returns the individual Kick gift events sent during a broadcast.

Each row includes sender, gift metadata, and the event timestamp inside the broadcast window.

GET /api/customer/v1/broadcasts/:broadcastId/gifts

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/gifts?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "sender_username": "viewer42",
      "gift_name": "Rocket",
      "gift_amount": 5,
      "message": "LFG",
      "event_time": "2026-03-17T20:10:00.000Z"
    }
  ],
  "totalItems": 57,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 3
}

Hata kodları 11 olası hata

POST

broadcast.audience_authenticity_job_create

Yayın audience authenticity skorunu sıraya al

/api/customer/v1/broadcasts/:broadcastId/audience-authenticity/jobs

Canlıda 8 units

Tek bir yayın için asenkron audience authenticity skoru oluşturur.

Yayın skoru sabit yayın aralığını kullanır ve sohbet içeriği, hesap/takip tarihleri, çapraz kanal aktivitesi ve izleyici/sohbet uyumunu birleştirir.

POST /api/customer/v1/broadcasts/:broadcastId/audience-authenticity/jobs

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Content-Type

string

Zorunlu

Required for JSON request bodies.

application/json

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

forceRefresh

Body

boolean

Opsiyonel

true ise tekrar kullanılabilir tamamlanmış snapshot atlanır ve yeni skor sıraya alınır.

false

Örnek istek bash

curl -X POST "https://kicklogz.com/api/customer/v1/broadcasts/892112233/audience-authenticity/jobs" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{
  "forceRefresh": false
}'

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "status": "queued",
  "jobId": "3d8f8930-6222-4d7c-9d64-936cbe0c3510",
  "reusedJob": false,
  "snapshotId": null,
  "scope": {
    "scopeType": "broadcast",
    "streamerSlug": "semm_usa",
    "broadcastId": 892112233
  },
  "queuedAt": "2026-05-21T18:05:00.000Z"
}

Hata kodları 11 olası hata

GET

broadcast.audience_authenticity_latest

Son yayın audience authenticity skoru

/api/customer/v1/broadcasts/:broadcastId/audience-authenticity/latest

Canlıda 2 units

Tek bir yayın için tamamlanmış son audience authenticity snapshotını döndürür.

Yayın skoru sıraya alındıktan sonra kullanılır. Tamamlanmış snapshot yoksa customer_api_audience_snapshot_not_found döner.

GET /api/customer/v1/broadcasts/:broadcastId/audience-authenticity/latest

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/audience-authenticity/latest" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "status": "completed",
  "reusedSnapshot": true,
  "snapshotId": "9d22ad34-a4be-444d-922d-7cb0be011567",
  "generatedAt": "2026-05-21T18:10:00.000Z",
  "result": {
    "schemaVersion": "customer_api_audience_authenticity_v1",
    "generatedAt": "2026-05-21T18:10:00.000Z",
    "scope": {
      "scopeType": "broadcast",
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "dateFrom": "2026-03-17T17:00:00.000Z",
      "dateTo": "2026-03-17T21:02:00.000Z"
    },
    "scores": {
      "authenticityScore": 91.4,
      "suspicionScore": 8.6,
      "confidenceScore": 76.2,
      "confidenceBand": "high"
    },
    "summary": {
      "streamerSlug": "semm_usa",
      "broadcastId": 892112233,
      "totalMessages": 18324,
      "uniqueChatters": 1260,
      "avgViewers": 18420,
      "peakViewers": 24112
    },
    "signals": {
      "emoteOnlyMessageShare": 0.18,
      "repeatedMessageRatio": 0.12,
      "singleChannelChatterShare": 0.22,
      "newKickAccountShare": 0.03,
      "newFollowerShare7d": 0.04,
      "newFollowerShare30d": 0.08
    },
    "explanation": {
      "headline": "Audience signals look mostly organic within the available data.",
      "limitations": [
        "Silent viewers cannot be identified directly.",
        "404/unknown Kick follow lookups are treated as unknown status, not bot evidence."
      ]
    }
  }
}

Hata kodları 12 olası hata

GET

broadcast.audience_authenticity_status

Yayın audience authenticity durumu

/api/customer/v1/broadcasts/:broadcastId/audience-authenticity/status

Canlıda 1 units

Tek bir yayın için audience authenticity skorunun hazır olup olmadığını kontrol eder.

JobId saklamadan yayını poll etmek için kullanılır. ready true ise üretilen result döner; değilse aynı yayın için son queued/running/failed job durumu döner.

GET /api/customer/v1/broadcasts/:broadcastId/audience-authenticity/status

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/audience-authenticity/status" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "ready": false,
  "status": "running",
  "jobId": "customer-api-search-123e4567-e89b-12d3-a456-426614174000",
  "snapshotId": null,
  "scope": {
    "scopeType": "broadcast",
    "streamerSlug": "semm_usa",
    "broadcastId": 892112233
  },
  "queuedAt": "2026-05-21T18:05:00.000Z",
  "startedAt": "2026-05-21T18:05:10.000Z",
  "completedAt": null,
  "failedAt": null,
  "error": null,
  "result": null,
  "paths": {
    "jobStatus": "/audience-authenticity/jobs/customer-api-search-123e4567-e89b-12d3-a456-426614174000",
    "latest": "/broadcasts/892112233/audience-authenticity/latest",
    "createJob": "/broadcasts/892112233/audience-authenticity/jobs"
  }
}

Hata kodları 12 olası hata

GET

broadcast.clips

Broadcast clips

/api/customer/v1/broadcasts/:broadcastId/clips

Canlıda 4 units

Returns clips generated from that specific broadcast.

Useful for replay pages, highlight exports, and clip indexing tied to one livestream.

GET /api/customer/v1/broadcasts/:broadcastId/clips

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

broadcastId

Path

integer

Zorunlu

Broadcast identifier.

892112233

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

20

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/clips?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "broadcast": {
    "broadcastId": 892112233,
    "livestreamId": 892112233,
    "channelId": 50291333,
    "isLive": false,
    "startTime": "2026-03-17T17:00:00.000Z",
    "endTime": "2026-03-17T21:02:00.000Z",
    "sessionTitle": "Ranked grind",
    "streamer": {
      "slug": "semm_usa",
      "chatroomId": 90500123,
      "channelId": 50291333,
      "language": "en",
      "profilepic": "https://kicklogz.com/images/logo.png"
    }
  },
  "data": [
    {
      "id": 4411,
      "title": "Clutch moment",
      "clip_url": "https://kick.com/clip/4411",
      "thumbnail_url": "https://kicklogz.com/images/logo.png",
      "duration_seconds": 28,
      "views": 5230,
      "created_at": "2026-03-18T02:33:00.000Z",
      "channel_username": "semm_usa"
    }
  ],
  "totalItems": 18,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 1
}

Hata kodları 11 olası hata

Arama

Asenkron geçmiş sohbet araması, iş durumu takibi ve paylaşım bağlantısı oluşturma.

4/4 Canlıda

GET

search.channel_resolve

Resolve channel

/api/customer/v1/search/channels/:channelName

Canlıda 1 base units × plan search multiplier Yayıncı kapsamlı

Resolves a channel slug into canonical slug and chatroom_id.

This is a lightweight helper before starting a search workflow.

GET /api/customer/v1/search/channels/:channelName

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

channelName

Path

string

Zorunlu

Kick channel slug.

semm_usa

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/search/channels/semm_usa" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "channelName": "semm_usa",
  "slug": "semm_usa",
  "chatroom_id": 90500123
}

Hata kodları 13 olası hata

POST

search.messages

Queue chat search

/api/customer/v1/search/messages

Canlıda 8 base units × plan search multiplier Yayıncı kapsamlı

Queues an asynchronous historical chat search job.

Arama bilinçli olarak asenkrondur. Burada bir job oluşturur, ardından completed veya failed olana kadar GET /search/jobs/:jobId ile durumu sorgularsınız. İsteğe bağlı limit göndererek daha az sonuç isteyebilirsiniz; üst sınır 250'dir. channelName'i atlayarak bir kullanıcı adını tüm kanallarda arayabilirsiniz; cross-channel job'lar tüm planlarda kullanılabilir, username gerektirir ve normal arama unit maliyetinin 2 katı faturalandırılır. Cross-channel job'lar, planın kanal bazlı arama penceresinden bağımsız olarak kayan son 30 günü sorgulayabilir.

POST /api/customer/v1/search/messages

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Content-Type

string

Zorunlu

Required for JSON request bodies.

application/json

channelName

Body

string

Opsiyonel

Hedef yayıncı slug'ı. Gönderildiğinde hesap/anahtar için yetkilendirilmiş olmalıdır. Opsiyoneldir: tüm kanallarda kullanıcı adı araması yapmak için bu alanı atlayın.

semm_usa

dateFrom

Body

ISO 8601 datetime

Zorunlu

Inclusive search start timestamp.

2026-03-20T00:00:00.000Z

dateTo

Body

ISO 8601 datetime

Zorunlu

Inclusive search end timestamp.

2026-03-22T00:00:00.000Z

query

Body

string

Opsiyonel

Free-text query. Minimum 3 characters.

smoke

username

Body

string

Opsiyonel

Exact username filter. Minimum 2 characters.

viewer42

oldUsernames

Body

array[string]

Opsiyonel

Optional historical usernames. Maximum 5 entries.

["viewer41","viewer40"]

limit

Body

integer

Opsiyonel

Optional result count for this page. Default 250. Minimum 1, maximum 250.

100

cursor

Body

object

Opsiyonel

Optional cursor from a previous completed result to continue pagination.

{"created_at":"2026-03-21T19:55:00.000Z","id":"1827107000100"}

Örnek istek bash

curl -X POST "https://kicklogz.com/api/customer/v1/search/messages" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{
  "channelName": "semm_usa",
  "dateFrom": "2026-03-20T00:00:00.000Z",
  "dateTo": "2026-03-22T00:00:00.000Z",
  "query": "smoke",
  "username": "viewer42",
  "oldUsernames": [
    "viewer41"
  ],
  "limit": 100,
  "cursor": {
    "created_at": "2026-03-21T19:55:00.000Z",
    "id": "1827107000100"
  }
}'

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "message": "Search queued successfully.",
  "jobId": "customer-api-search-123e4567-e89b-12d3-a456-426614174000",
  "limit": 100,
  "crossChannel": false,
  "initialPosition": 2,
  "queue": {
    "name": "search-queue-pro",
    "priority": 10,
    "isolation": "shared_pro_queue_deprioritized"
  }
}

Hata kodları 29 olası hata

GET

search.status

Search job status

/api/customer/v1/search/jobs/:jobId

Canlıda 0 base units

Reads queue state or final results for a previously created search job.

Possible statuses are waiting, active, completed, or failed. The response echoes the effective limit used for the job. Completed results include up to the requested limit, capped at 250, plus the nextCursor for follow-up pagination.

GET /api/customer/v1/search/jobs/:jobId

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

jobId

Path

string

Zorunlu

Job ID returned by an asynchronous Customer API endpoint.

customer-api-search-123e4567-e89b-12d3-a456-426614174000

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/search/jobs/customer-api-search-123e4567-e89b-12d3-a456-426614174000" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "status": "completed",
  "limit": 100,
  "data": {
    "total": 2,
    "hits": [
      {
        "id": "1827107192312",
        "user_id": 998811,
        "username": "viewer42",
        "color": "#53FC18",
        "content": "gg wp",
        "created_at": "2026-03-21T21:20:11.000Z",
        "created_at_formatted": "21.03.2026 21:20:11",
        "chatroom_id": 90500123,
        "channel_slug": "semm_usa",
        "channel_profilepic": "https://kicklogz.com/images/logo.png",
        "channel_id": 50291333
      }
    ],
    "nextCursor": {
      "created_at": "2026-03-21T21:20:11.000Z",
      "id": "1827107192312"
    },
    "relation": "eq"
  }
}

Hata kodları 14 olası hata

POST

search.share

Share search

/api/customer/v1/search/share

Canlıda 1 base units × plan search multiplier

Creates a short-lived share link for a specific KickLogz API search configuration.

This is useful for support handoff, saved investigations, or sharing a search preset with another internal tool. If limit is provided, the share link preserves that requested result size up to 250.

POST

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Content-Type

string

Zorunlu

Required for JSON request bodies.

application/json

channelName

Body

string

Zorunlu

Target streamer slug for the shared search.

semm_usa

dateFrom

Body

ISO 8601 datetime

Zorunlu

Inclusive search start timestamp.

2026-03-20T00:00:00.000Z

dateTo

Body

ISO 8601 datetime

Zorunlu

Inclusive search end timestamp.

2026-03-22T00:00:00.000Z

query

Body

string

Opsiyonel

Optional free-text query. Minimum 3 characters.

smoke

username

Body

string

Opsiyonel

Optional exact username filter. Minimum 2 characters.

viewer42

limit

Body

integer

Opsiyonel

Optional result count to preserve in the shared search. Default 250. Minimum 1, maximum 250.

100

scrollPage

Body

integer

Opsiyonel

Optional page number to reopen inside the shared result view.

1

scrollTopTs

Body

integer

Opsiyonel

Optional topmost visible timestamp in Unix milliseconds.

1742587200000

Örnek istek bash

curl -X POST "https://kicklogz.com/api/customer/v1/search/share" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{
  "channelName": "semm_usa",
  "dateFrom": "2026-03-20T00:00:00.000Z",
  "dateTo": "2026-03-22T00:00:00.000Z",
  "query": "smoke",
  "username": "viewer42",
  "limit": 100,
  "scrollPage": 1,
  "scrollTopTs": 1742587200000
}'

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "shortUrl": "/s/Ab3x9PqL",
  "expiresInSeconds": 2592000
}

Hata kodları 20 olası hata

Kick profilleri

Ban, hediye, ödül, klip ve kullanıcı adı geçmişi için kullanıcı odaklı endpoint'ler.

7/7 Canlıda

GET

kick_profile.bans

Kick profile bans

/api/customer/v1/kick-profiles/:username/bans

Canlıda 3 units

Returns ban history rows for a specific Kick username.

This is user-centric rather than streamer-centric, so it aggregates where that user was banned across tracked channels.

GET /api/customer/v1/kick-profiles/:username/bans

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/bans?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "username": "toxic_user",
      "channel_name": "semm_usa",
      "banned_by_username": "mod_jane",
      "created_at": "2026-03-18T22:00:00.000Z",
      "expires_at": "2026-03-19T22:00:00.000Z"
    }
  ],
  "totalItems": 16,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 2
}

Hata kodları 10 olası hata

GET

kick_profile.received_subs

Kick profile received subscriptions

/api/customer/v1/kick-profiles/:username/received-subs

Canlıda 3 units

Returns channels that subscribed to the target user during the recent 30-day window.

Rows include the channel slug, month count, gifted flag, and latest subscription event time.

GET /api/customer/v1/kick-profiles/:username/received-subs

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/received-subs?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "channel_name": "semm_usa",
      "months": 3,
      "is_gifted": false,
      "gifter_username": null,
      "event_time": "2026-03-20T19:00:00.000Z"
    }
  ],
  "totalItems": 8,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 1
}

Hata kodları 10 olası hata

GET

kick_profile.gifted_subs

Kick profile gifted subscriptions

/api/customer/v1/kick-profiles/:username/gifted-subs

Canlıda 3 units

Returns channels where the target user gifted subscriptions in the recent 30-day window.

This is useful for sponsor tracking, gifting leaderboards, and supporter activity views.

GET /api/customer/v1/kick-profiles/:username/gifted-subs

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/gifted-subs?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "channel_name": "semm_usa",
      "gift_count": 14,
      "event_time": "2026-03-20T20:00:00.000Z"
    }
  ],
  "totalItems": 5,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 1
}

Hata kodları 10 olası hata

GET

kick_profile.rewards

Kick profile rewards

/api/customer/v1/kick-profiles/:username/rewards

Canlıda 3 units

Returns reward redemptions performed by the target Kick user.

Each row includes the reward title, optional user input, channel slug, and redemption time.

GET /api/customer/v1/kick-profiles/:username/rewards

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/rewards?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "reward_title": "Hydrate",
      "user_input": "500ml",
      "redeemed_at": "2026-03-17T20:02:00.000Z",
      "reward_background_color": "#53FC18",
      "channel_name": "semm_usa"
    }
  ],
  "totalItems": 23,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 3
}

Hata kodları 10 olası hata

GET

kick_profile.sent_kicks

Kick profile sent KICKs

/api/customer/v1/kick-profiles/:username/sent-kicks

Canlıda 3 units

Returns the total gifts sent by the target user grouped by channel.

Useful for monetization and supporter activity dashboards focused on one viewer account.

GET /api/customer/v1/kick-profiles/:username/sent-kicks

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/sent-kicks?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "channel_name": "semm_usa",
      "total_amount": 1240
    }
  ],
  "totalItems": 11,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 2
}

Hata kodları 10 olası hata

GET

kick_profile.clips

Kick profile clips

/api/customer/v1/kick-profiles/:username/clips

Canlıda 3 units

Returns clips created by the target Kick user.

This endpoint is creator-scoped and helps build viewer or editor clip portfolios.

GET /api/customer/v1/kick-profiles/:username/clips

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

12

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/kick-profiles/viewer42/clips?page=1&limit=12" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "id": 4411,
      "title": "Clutch moment",
      "clip_url": "https://kick.com/clip/4411",
      "thumbnail_url": "https://kicklogz.com/images/logo.png",
      "duration_seconds": 28,
      "views": 5230,
      "created_at": "2026-03-18T02:33:00.000Z",
      "channel_username": "semm_usa"
    }
  ],
  "totalItems": 31,
  "currentPage": 1,
  "itemsPerPage": 12,
  "totalPages": 3
}

Hata kodları 10 olası hata

GET

kick_profile.username_history

Kick profile username history

/api/customer/v1/users/:username/username-history

Canlıda 2 units

Returns previous known usernames for the target Kick account.

Helpful for search expansion, moderation investigations, and alias resolution workflows.

GET /api/customer/v1/users/:username/username-history

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

username

Path

string

Zorunlu

Kick username.

viewer42

page

Query

integer

Opsiyonel

1-based page number.

1

limit

Query

integer

Opsiyonel

Maximum number of rows to return. Must respect plan maxPageSize (100).

10

Örnek istek bash

curl -X GET "https://kicklogz.com/api/customer/v1/users/viewer42/username-history?page=1&limit=10" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "username": "viewer41",
      "first_seen_at": "2025-12-01T08:00:00.000Z",
      "last_seen_at": "2026-01-10T18:30:00.000Z",
      "usage_count": 53
    },
    {
      "username": "viewer40",
      "first_seen_at": "2025-07-18T09:20:00.000Z",
      "last_seen_at": "2025-11-30T22:15:00.000Z",
      "usage_count": 19
    }
  ],
  "totalItems": 2,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 1
}

Hata kodları 10 olası hata

Management

Write endpoints for Customer API account configuration automation.

2/2 Canlıda

POST

management.streamer_entitlements.create

Add streamer entitlement

/api/customer/v1/entitlements/streamers

Canlıda 1 units

Adds a streamer slug to the authenticated account approved streamer list.

Use this from trusted automation when you need to approve a streamer without opening the dashboard. The endpoint respects the account streamer limit.

POST /api/customer/v1/entitlements/streamers

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

Content-Type

string

Zorunlu

Required for JSON request bodies.

application/json

streamerSlug

Body

string

Zorunlu

Streamer slug to add to the approved streamer list.

semm_usa

Örnek istek bash

curl -X POST "https://kicklogz.com/api/customer/v1/entitlements/streamers" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{
  "streamerSlug": "semm_usa"
}'

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "version": "v1",
  "streamer": {
    "streamerSlug": "semm_usa",
    "channelId": 50291333,
    "chatroomId": 90500123,
    "displayName": "Semm USA"
  }
}

Hata kodları 12 olası hata

DELETE

management.streamer_entitlements.delete

Remove streamer entitlement

/api/customer/v1/entitlements/streamers/:streamerSlug

Canlıda 1 units

Removes a streamer slug from the authenticated account approved streamer list.

Use this from trusted automation when a streamer should no longer be available to the account or selected API keys.

DELETE /api/customer/v1/entitlements/streamers/:streamerSlug

İstek

Örnek istek

Bu endpoint'e gönderilecek header, parametre ve body alanları.

bash

İstek alanları

Alan Konum Tip Zorunluluk Açıklama Örnek

x-kicklogz-api-key

string

Zorunlu

Secret KickLogz API key created in Profile > KickLogz API.

klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef

streamerSlug

Path

string

Zorunlu

StreamerSlug value.

streamerSlug

Örnek istek bash

curl -X DELETE "https://kicklogz.com/api/customer/v1/entitlements/streamers/semm_usa" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"

Yanıt

Başarılı yanıt

Bu endpoint'in başarılı JSON yanıtlarından bir örnek.

HTTP 200

Örnek yanıt json

{
  "success": true,
  "version": "v1",
  "streamerSlug": "semm_usa"
}

Hata kodları 11 olası hata

KickLogz API Dokümantasyonu

Bağlantı detayları

Bağlantı detayları

Genel bakış

KickLogz API'yi kullanmaya başla

Hızlı kurulum

Mevcut paketler

Hata yanıt formatı

Tüm endpoint kataloğunda ara

Meta

Account summary

İstek alanları

Usage snapshot

İstek alanları

Live catalog

İstek alanları

Streamer entitlements

İstek alanları

Yayıncı profilleri

Streamer summary

İstek alanları

Unique chatters

İstek alanları

Yayıncı izleyici sohbetçileri

İstek alanları

Emote usage total

İstek alanları

First tracked message

İstek alanları

Latest chat messages

İstek alanları

Hourly activity chart

İstek alanları

Popular categories

İstek alanları

Popular emotes

İstek alanları

Daily trend

İstek alanları

Most active chatters

İstek alanları

Room settings history

İstek alanları

Subscription summary

İstek alanları

Normal subscribers

İstek alanları

Gifted subscribers

İstek alanları

Top gifters

İstek alanları

Latest gifts

İstek alanları

Gift total

İstek alanları

Ban history

İstek alanları

Top moderators

İstek alanları

Hosts history

İstek alanları

Poll history

İstek alanları

Prediction summaries

İstek alanları

Prediction history

İstek alanları

Pinned messages

İstek alanları

Reward stats

İstek alanları

Broadcast history

İstek alanları

Yayıncı audience authenticity skorunu sıraya al

İstek alanları

Son yayıncı audience authenticity skoru

İstek alanları

Yayıncı audience authenticity durumu

İstek alanları

Audience authenticity job durumu