Rechercher Détails du spectateur Streamers Statistiques Classements Actualités Premium API Docs
Présentation de l’API KickLogz, du Tableau de Bord Équipe et des Notifications Tracker Avancées 🚀
KickLogz API vv1

Documentation KickLogz API

Accès en lecture seule aux analyses de streamers, aux métadonnées du compte et aux flux de recherche historique.

Acheter un accès API Créer une clé API
Général

Détails de connexion

URL de base, en-tête d’authentification et informations générales sur l’API.

Détails de connexion
URL de base https://kicklogz.com/api/customer/v1
Chemin de base /api/customer/v1
En-tête d’authentification x-kicklogz-api-key
Exemple de clé API klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Aperçu
Endpoints documentés 56
Disponibles 55
Bientôt 1
L’endpoint catalogue renvoie uniquement les endpoints approuvés au lancement que la clé authentifiée peut utiliser actuellement.
La recherche est asynchrone : créez d’abord un job, puis interrogez l’endpoint de statut jusqu’à sa fin.
Les endpoints de recherche consomment des unités de base multipliées par le searchUnitCostMultiplier du plan.
Les limites de taille de page et de plage de dates dépendent de l’endpoint et du plan du compte et sont appliquées côté serveur à chaque requête.
Configuration rapide

Commencez avec KickLogz API

Suivez ces étapes pour acheter l'accès, créer une clé et envoyer votre première requête.

Configuration rapide
  1. 1. Achetez l’accès

    Achetez un plan KickLogz API depuis la page des packs.

    Ouvrir les packs
  2. 2. Créez une clé API

    Ouvrez Profil > KickLogz API et créez une clé avec la portée streamer et les familles d’endpoints autorisées.

    Ouvrir le profil
  3. 3. Envoyez des requêtes en lecture seule

    Ajoutez x-kicklogz-api-key à chaque requête. Tous les endpoints KickLogz API sont en lecture seule.

cURL de démarrage rapide bash 
curl -X GET "https://kicklogz.com/api/customer/v1/account" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Plans et limites

Plans disponibles

Choisissez un plan et consultez son débit, son quota et ses limites de streamers.

Starter 1 Streamer
  • 1 streamer
  • 20 RPM
  • 1 concurrency
  • 12,000 monthly units
  • 3 day search window
Scale 50 Streamers
  • 50 streamers
  • 60 RPM
  • 3 concurrency
  • 150,000 monthly units
  • 7 day search window
Enterprise Unlimited
  • Unlimited streamers
  • 120 RPM
  • 6 concurrency
  • 1,000,000 monthly units
  • 14 day search window
Feuille de route

Endpoints à venir

Prévisualisez les familles d’endpoints prévues ou déjà construites mais pas encore publiques.

1 Pas encore disponible
1 Familles en attente
Kick profiles 1 en attente
1 prévu
  • kick_profile.username_history Coming soon
Erreurs

Format de réponse d’erreur

Enveloppe JSON standard renvoyée par KickLogz API.

Réponse d’erreur JSON json 
{
  "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
}
Explorateur d’endpoints

Rechercher dans le catalogue complet des endpoints

Recherchez par code, méthode, chemin, famille ou description.

56 endpoints

Meta

Authentication, catalog, quota, and entitlement helper endpoints.

disponibles total
GET

Account summary

/api/customer/v1/account
Live now 0 units Portée compte

Returns the authenticated account, key metadata, effective limits, and latest usage snapshot.

Use this first after key creation to confirm plan limits, environment, and whether search is enabled.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Codes d'erreur
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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/account" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "version": "v1",
  "basePath": "/api/customer/v1",
  "account": {
    "id": "capi_acc_1001",
    "planCode": "starter_1",
    "status": "active",
    "allowAllStreamers": false,
    "streamerLimit": 1,
    "stripeSubscriptionId": "sub_1TDaI2P60eWI0gWuYDRV5o1E"
  },
  "apiKey": {
    "id": "capi_key_101",
    "label": "Production key",
    "prefix": "klz_live_0123456789abcdef",
    "environment": "live",
    "expiresAt": null,
    "lastUsedAt": "2026-03-22T02:25:17.000Z"
  },
  "limits": {
    "enabledFamilies": [
      "meta",
      "streamer_profile",
      "broadcast",
      "search",
      "kick_profile"
    ],
    "allowAllStreamers": false,
    "streamerLimit": 1,
    "maxPageSize": 100,
    "maxDateRangeDays": 7,
    "rpmLimit": 20,
    "concurrencyLimit": 1,
    "monthlyRequestLimit": 5000,
    "monthlyUnitLimit": 12000,
    "searchEnabled": true,
    "searchMaxDateRangeDays": 3,
    "searchRpmLimit": 6,
    "searchConcurrencyLimit": 1,
    "searchUnitCostMultiplier": 5
  },
  "usage": {
    "usageMonth": "2026-03-01",
    "limits": {
      "enabledFamilies": [
        "meta",
        "streamer_profile",
        "broadcast",
        "search",
        "kick_profile"
      ],
      "allowAllStreamers": false,
      "streamerLimit": 1,
      "maxPageSize": 100,
      "maxDateRangeDays": 7,
      "rpmLimit": 20,
      "concurrencyLimit": 1,
      "monthlyRequestLimit": 5000,
      "monthlyUnitLimit": 12000,
      "searchEnabled": true,
      "searchMaxDateRangeDays": 3,
      "searchRpmLimit": 6,
      "searchConcurrencyLimit": 1,
      "searchUnitCostMultiplier": 5
    },
    "usage": {
      "requestsUsed": 42,
      "unitsUsed": 118,
      "searchRequestsUsed": 4,
      "searchUnitsUsed": 80,
      "streamerProfileRequestsUsed": 18,
      "broadcastRequestsUsed": 0,
      "kickProfileRequestsUsed": 0
    },
    "remaining": {
      "requestsRemaining": 4958,
      "unitsRemaining": 11882
    }
  }
}
GET

Usage snapshot

/api/customer/v1/usage
Live now 0 units Portée compte

Returns current monthly request and unit usage for the authenticated account.

The payload includes both raw usage counters and remaining monthly quota.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Codes d'erreur
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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/usage" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "version": "v1",
  "usage": {
    "usageMonth": "2026-03-01",
    "limits": {
      "enabledFamilies": [
        "meta",
        "streamer_profile",
        "broadcast",
        "search",
        "kick_profile"
      ],
      "allowAllStreamers": false,
      "streamerLimit": 1,
      "maxPageSize": 100,
      "maxDateRangeDays": 7,
      "rpmLimit": 20,
      "concurrencyLimit": 1,
      "monthlyRequestLimit": 5000,
      "monthlyUnitLimit": 12000,
      "searchEnabled": true,
      "searchMaxDateRangeDays": 3,
      "searchRpmLimit": 6,
      "searchConcurrencyLimit": 1,
      "searchUnitCostMultiplier": 5
    },
    "usage": {
      "requestsUsed": 42,
      "unitsUsed": 118,
      "searchRequestsUsed": 4,
      "searchUnitsUsed": 80,
      "streamerProfileRequestsUsed": 18,
      "broadcastRequestsUsed": 0,
      "kickProfileRequestsUsed": 0
    },
    "remaining": {
      "requestsRemaining": 4958,
      "unitsRemaining": 11882
    }
  }
}
GET

Live catalog

/api/customer/v1/catalog
Live now 0 units Portée compte

Returns only the launch-approved endpoints that the authenticated account can call today.

This is the best runtime source of truth if you want to discover the exact families and endpoints enabled for a specific key.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Codes d'erreur
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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/catalog" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "version": "v1",
  "groups": [
    {
      "family": "meta",
      "endpoints": [
        {
          "code": "meta.account",
          "method": "GET",
          "path": "/api/customer/v1/account",
          "family": "meta",
          "units": 0,
          "implemented": true,
          "launchApproved": true,
          "backendStatus": "ready",
          "streamerScoped": false,
          "note": "Authenticated account summary and effective limits."
        }
      ]
    },
    {
      "family": "streamer_profile",
      "endpoints": [
        {
          "code": "streamer.summary",
          "method": "GET",
          "path": "/api/customer/v1/streamers/:slug",
          "family": "streamer_profile",
          "units": 1,
          "implemented": true,
          "launchApproved": true,
          "backendStatus": "ready",
          "streamerScoped": true,
          "note": null
        }
      ]
    }
  ]
}
GET

Streamer entitlements

/api/customer/v1/entitlements/streamers
Live now 0 units Portée compte

Lists the streamer slugs currently assigned to the authenticated account.

Useful when you manage many streamers and want to sync allowed slugs into your application.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/entitlements/streamers?page=1&limit=20" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "version": "v1",
  "allowAllStreamers": false,
  "streamerLimit": 1,
  "data": [
    {
      "streamer_slug": "semm_usa",
      "channel_id": 50291333,
      "chatroom_id": 90500123,
      "display_name": "Semm USA",
      "source": "subscription_sync",
      "added_at": "2026-03-01T12:00:00.000Z",
      "created_at": "2026-03-01T12:00:00.000Z",
      "updated_at": "2026-03-01T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 1,
    "totalPages": 1
  }
}

Streamer profiles

Read-only streamer profile, chat, subscription, and analytics endpoints.

disponibles total
GET

Streamer summary

/api/customer/v1/streamers/:slug
Live now 1 units Portée streamer

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

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

streamer_not_found HTTP 404
Streamer not found.

The supplied streamer slug could not be resolved.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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
  }
}
GET

Unique chatters

/api/customer/v1/streamers/:slug/users
Live now 1 units Portée streamer

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

Good for DAU-style streamer activity analysis.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/users" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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
}
GET

Emote usage total

/api/customer/v1/streamers/:slug/emotes
Live now 1 units Portée streamer

Counts messages containing emotes during the last 30 days.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/emotes" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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
}
GET

First tracked message

/api/customer/v1/streamers/:slug/first-message
Live now 1 units Portée streamer

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/first-message" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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"
}
GET

Latest chat messages

/api/customer/v1/streamers/:slug/messages
Live now 5 units Portée streamer

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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"
    }
  ]
}
GET

Hourly activity chart

/api/customer/v1/streamers/:slug/charts/hourly-activity
Live now 2 units Portée streamer

Returns 24 hourly buckets for recent streamer chat activity.

Useful for understanding which hours generate the most chat volume.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête 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"
Exemple de réponse 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
  ]
}
GET

Daily trend

/api/customer/v1/streamers/:slug/charts/daily-trend
Live now 2 units Portée streamer

Returns daily message totals for the recent trend window.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête 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"
Exemple de réponse 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
  ]
}
GET

Most active chatters

/api/customer/v1/streamers/:slug/charts/active-users
Live now 2 units Portée streamer

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

This endpoint is useful for leaderboard widgets or moderation dashboards.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
  ]
}
GET

Room settings history

/api/customer/v1/streamers/:slug/room-settings
Live now 2 units Portée streamer

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

Useful for auditing how room restrictions changed over time.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Codes d'erreur
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_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_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_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.

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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/room-settings" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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"
    }
  ]
}
GET

Subscription summary

/api/customer/v1/streamers/:slug/subscriptions
Live now 2 units Portée streamer

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

Designed for overview cards without requiring multiple paginated calls.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
    }
  ]
}
GET

Normal subscribers

/api/customer/v1/streamers/:slug/subscriptions/normal
Live now 3 units Portée streamer

Returns paginated normal subscribers for the last 30 days.

Each record represents the latest known subscription state per username.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Gifted subscribers

/api/customer/v1/streamers/:slug/subscriptions/gifted
Live now 3 units Portée streamer

Returns paginated gifted subscription events for the last 30 days.

Records include the gifting username when present.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Top gifters

/api/customer/v1/streamers/:slug/subscriptions/top-gifters
Live now 3 units Portée streamer

Returns paginated top gifters ranked by gift count.

Good for sponsor, community, or monetization dashboards.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Latest gifts

/api/customer/v1/streamers/:channelId/gifts/latest
Live now 3 units Portée compte

Returns paginated latest Kick gifts for a channel ID.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
channelId integer

Kick channel ID for the streamer.

Exemple: 50291333
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

streamer_channel_not_found HTTP 404
Streamer channel not found.

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

Exemple de requête 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"
Exemple de réponse 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
}
GET

Gift total

/api/customer/v1/streamers/:channelId/gifts/total
Live now 1 units Portée compte

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

A compact metric endpoint for monetization summaries.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
channelId integer

Kick channel ID for the streamer.

Exemple: 50291333
Codes d'erreur
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_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_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_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.

streamer_channel_not_found HTTP 404
Streamer channel not found.

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

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/50291333/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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
}
GET

Ban history

/api/customer/v1/streamers/:slug/bans
Live now 3 units Portée streamer

Returns paginated ban events for the last 30 days.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Top moderators

/api/customer/v1/streamers/:slug/top-moderators
Live now 2 units Portée streamer

Returns moderators ranked by recorded ban activity.

A lightweight aggregate endpoint for moderation leaderboards.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
    }
  ]
}
GET

Hosts history

/api/customer/v1/streamers/:slug/hosts
Live now 3 units Portée streamer

Returns paginated host/raid style events.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Poll history

/api/customer/v1/streamers/:slug/polls
Live now 3 units Portée streamer

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

Poll options are returned as parsed JSON when available.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Prediction summaries

/api/customer/v1/streamers/:slug/predictions
Live now 3 units Portée streamer

Returns paginated prediction summaries for the streamer channel.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

streamer_not_found HTTP 404
Streamer not found.

The supplied streamer slug could not be resolved.

streamer_channel_not_found HTTP 404
Streamer channel not found.

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

Exemple de requête 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"
Exemple de réponse 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
}
GET

Prediction history

/api/customer/v1/predictions/:predictionId/history
Live now 3 units Portée compte

Returns the full ordered event history for a single prediction.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
predictionId string

Prediction identifier returned by prediction endpoints.

Exemple: pred_1177001
Codes d'erreur
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_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_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_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.

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.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/predictions/pred_1177001/history" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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
        }
      ]
    }
  ]
}
GET

Pinned messages

/api/customer/v1/streamers/:slug/pinned-messages
Live now 3 units Portée streamer

Returns paginated pinned message history.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Reward stats

/api/customer/v1/streamers/:slug/reward-stats
Live now 3 units Portée streamer

Returns top redeemers plus reward redemption pagination blocks.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

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.

streamer_not_found HTTP 404
Streamer not found.

The supplied streamer slug could not be resolved.

streamer_channel_not_found HTTP 404
Streamer channel not found.

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

Exemple de requête 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"
Exemple de réponse 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
  }
}
GET

Broadcast history

/api/customer/v1/streamers/:slug/broadcasts
Live now 3 units Portée streamer

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

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
search string

Case-insensitive title or slug filter.

Exemple: ranked
startDate date

Inclusive broadcast start date filter.

Exemple: 2026-03-01
endDate date

Inclusive broadcast end date filter.

Exemple: 2026-03-22
Codes d'erreur
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_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_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_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.

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.

streamer_not_found HTTP 404
Streamer not found.

The supplied streamer slug could not be resolved.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Clips

/api/customer/v1/streamers/:slug/clips
Live now 3 units Portée streamer

Returns paginated clips for the streamer channel.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
slug string

Streamer slug assigned to the account or API key.

Exemple: semm_usa
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

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.

streamer_not_found HTTP 404
Streamer not found.

The supplied streamer slug could not be resolved.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Similar streamers

/api/customer/v1/streamers/:chatroomId/similar
Live now 4 units Portée compte

Returns a list of streamers similar to the supplied chatroom.

Useful for recommendation widgets or competitor discovery.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
chatroomId integer

Kick chatroom ID for the streamer.

Exemple: 90500123
Paramètres de requête
limit integer

Maximum similar streamers to return.

Exemple: 6
Codes d'erreur
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_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_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_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.

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.

streamer_chatroom_not_found HTTP 404
Streamer chatroom not found.

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

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/90500123/similar?limit=6" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse 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": [
    {
      "slug": "another_streamer",
      "chatroom_id": 80555111,
      "channel_id": 71220001,
      "language": "en",
      "similarity_score": 0.92
    }
  ]
}

Broadcast analytics

Broadcast-scoped analytics, activity, gifting, and clip endpoints.

disponibles total
GET

Broadcast stats

/api/customer/v1/broadcasts/:broadcastId/stats
Live now 4 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Codes d'erreur
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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/stats" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
  ]
}
GET

Broadcast top chatters

/api/customer/v1/broadcasts/:broadcastId/top-chatters
Live now 4 units Portée compte

Returns the most active usernames inside a single broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "data": [
    {
      "username": "viewer42",
      "message_count": 84
    }
  ],
  "totalItems": 126,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 13
}
GET

Broadcast keywords

/api/customer/v1/broadcasts/:broadcastId/keywords
Live now 4 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "data": [
    {
      "keyword": "gg",
      "count": 118,
      "unique_users": 73
    }
  ],
  "totalItems": 48,
  "currentPage": 1,
  "itemsPerPage": 20,
  "totalPages": 3
}
GET

Broadcast polls

/api/customer/v1/broadcasts/:broadcastId/polls
Live now 4 units Portée compte

Returns poll events created during the selected broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast predictions

/api/customer/v1/broadcasts/:broadcastId/predictions
Live now 4 units Portée compte

Returns prediction events created during the broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast bans

/api/customer/v1/broadcasts/:broadcastId/bans
Live now 4 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast pinned messages

/api/customer/v1/broadcasts/:broadcastId/pinned-messages
Live now 4 units Portée compte

Returns pinned chat messages created during that broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast hosts

/api/customer/v1/broadcasts/:broadcastId/hosts
Live now 4 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast subscribers

/api/customer/v1/broadcasts/:broadcastId/subscribers
Live now 4 units Portée compte

Returns subscription events that happened during the broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
type string

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

Exemple: all
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast top gifters

/api/customer/v1/broadcasts/:broadcastId/top-gifters
Live now 4 units Portée compte

Returns the top gifter leaderboard for a single broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "data": [
    {
      "gifter_username": "biggifter",
      "total_gifts": 14,
      "last_gift_date": "2026-03-17T20:12:00.000Z"
    }
  ],
  "totalItems": 9,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 1
}
GET

Broadcast gift total

/api/customer/v1/broadcasts/:broadcastId/gifts/total
Live now 2 units Portée compte

Returns the total Kick gifts tracked during the broadcast window.

A compact monetization metric for stream summaries and revenue dashboards.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Codes d'erreur
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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête bash 
curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "total_gifts": 241
}
GET

Broadcast gifts

/api/customer/v1/broadcasts/:broadcastId/gifts
Live now 4 units Portée compte

Returns the individual Kick gift events sent during a broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}
GET

Broadcast clips

/api/customer/v1/broadcasts/:broadcastId/clips
Live now 4 units Portée compte

Returns clips generated from that specific broadcast.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
broadcastId string

Broadcast identifier.

Exemple: 892112233
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 20
Codes d'erreur
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_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_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_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.

broadcast_not_found HTTP 404
Broadcast not found.

The broadcast identifier could not be resolved.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "broadcast": {
    "id": "892112233",
    "streamer_slug": "semm_usa",
    "channel_id": 50291333,
    "chatroom_id": 90500123,
    "title": "Ranked grind",
    "started_at": "2026-03-17T17:00:00.000Z",
    "ended_at": "2026-03-17T21:02:00.000Z",
    "is_live": false
  },
  "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
}

Kick profiles

User-centric read endpoints for bans, gifts, rewards, clips, and username history.

disponibles total
GET

Kick profile bans

/api/customer/v1/kick-profiles/:username/bans
Live now 3 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Kick profile received subscriptions

/api/customer/v1/kick-profiles/:username/received-subs
Live now 3 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Kick profile gifted subscriptions

/api/customer/v1/kick-profiles/:username/gifted-subs
Live now 3 units Portée compte

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.

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Kick profile rewards

/api/customer/v1/kick-profiles/:username/rewards
Live now 3 units Portée compte

Returns reward redemptions performed by the target Kick user.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Kick profile sent KICKs

/api/customer/v1/kick-profiles/:username/sent-kicks
Live now 3 units Portée compte

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

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse json 
{
  "success": true,
  "user": {
    "username": "viewer42"
  },
  "data": [
    {
      "channel_name": "semm_usa",
      "total_amount": 1240
    }
  ],
  "totalItems": 11,
  "currentPage": 1,
  "itemsPerPage": 10,
  "totalPages": 2
}
GET

Kick profile clips

/api/customer/v1/kick-profiles/:username/clips
Live now 3 units Portée compte

Returns clips created by the target Kick user.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 12
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse 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
}
GET

Kick profile username history

/api/customer/v1/users/:username/username-history
Coming soon 2 units Portée compte

Returns previous known usernames for the target Kick account.

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

Paramètres
En-têtes
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Exemple: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Paramètres de chemin
username string

Kick username.

Exemple: viewer42
Paramètres de requête
page integer

1-based page number.

Exemple: 1
limit integer

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

Exemple: 10
Codes d'erreur
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_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_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_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.

Exemple de requête 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"
Exemple de réponse text 
[object Object]