Buscar Detalles del Espectador Streamers Estadísticas Tablas de Clasificación Noticias Premium API Docs
Presentamos la API de KickLogz, el Panel de Equipo y las Notificaciones Avanzadas del Tracker 🚀
KickLogz API vv1

Documentación de KickLogz API

Acceso de solo lectura a analíticas de streamers, metadatos de la cuenta y flujos de búsqueda histórica.

Comprar acceso API Crear clave API
General

Detalles de conexión

URL base, encabezado de autenticación e información básica de la API.

Detalles de conexión
URL base https://kicklogz.com/api/customer/v1
Ruta base /api/customer/v1
Encabezado de autenticación x-kicklogz-api-key
Ejemplo de clave API klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Resumen
Endpoints documentados 56
Activos 55
Próximamente 1
El endpoint de catálogo devuelve solo los endpoints aprobados para lanzamiento que la clave autenticada puede usar en este momento.
La búsqueda es asíncrona: primero crea un trabajo y luego consulta el endpoint de estado hasta que finalice.
Los endpoints de búsqueda consumen unidades base multiplicadas por el searchUnitCostMultiplier del plan.
Los límites de tamaño de página y rango de fechas dependen del endpoint y del plan de la cuenta y se aplican en el servidor en cada solicitud.
Configuración rápida

Empieza a usar KickLogz API

Sigue estos pasos para comprar acceso, crear una clave y enviar tu primera solicitud.

Configuración rápida
  1. 1. Compra acceso

    Compra un plan de KickLogz API desde la página de paquetes.

    Abrir paquetes
  2. 2. Crea una clave API

    Abre Perfil > KickLogz API y crea una clave con el alcance de streamers y familias de endpoints permitidos.

    Abrir perfil
  3. 3. Envía solicitudes de solo lectura

    Incluye x-kicklogz-api-key en cada solicitud. Todos los endpoints de KickLogz API son de solo lectura.

cURL de inicio rápido bash 
curl -X GET "https://kicklogz.com/api/customer/v1/account" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Planes y límites

Planes disponibles

Elige un plan y revisa su tasa, cuota y límites 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
Hoja de ruta

Próximos endpoints

Vista previa de familias de endpoints planificadas o ya construidas pero todavía no públicas.

1 Aún no disponible
1 Familias en cola
Perfiles de Kick 1 en cola
1 planificado
  • kick_profile.username_history Próximamente
Errores

Formato de respuesta de error

Formato JSON estándar de error devuelto por KickLogz API.

Respuesta JSON de error 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
}
Explorador de endpoints

Buscar en el catálogo completo de endpoints

Busca por código, método, ruta, familia o descripción.

56 endpoints

Meta

Endpoints auxiliares para autenticación, catálogo, cuota y accesos.

activos total
GET

Account summary

/api/customer/v1/account
Activo 0 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/account" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 0 units Con alcance de cuenta

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

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/usage" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 0 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/catalog" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 0 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
  }
}

Perfiles de streamer

Endpoints de solo lectura para perfil, chat, suscripciones y analíticas del streamer.

activos total
GET

Streamer summary

/api/customer/v1/streamers/:slug
Activo 1 units Con alcance de 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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 1 units Con alcance de streamer

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

Good for DAU-style streamer activity analysis.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/users" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 1 units Con alcance de streamer

Counts messages containing emotes during the last 30 days.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/emotes" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 1 units Con alcance de 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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/first-message" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 5 units Con alcance de 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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

Returns 24 hourly buckets for recent streamer chat activity.

Useful for understanding which hours generate the most chat volume.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

Returns daily message totals for the recent trend window.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

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

This endpoint is useful for leaderboard widgets or moderation dashboards.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

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

Useful for auditing how room restrictions changed over time.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/semm_usa/room-settings" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

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

Designed for overview cards without requiring multiple paginated calls.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated normal subscribers for the last 30 days.

Each record represents the latest known subscription state per username.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated gifted subscription events for the last 30 days.

Records include the gifting username when present.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated top gifters ranked by gift count.

Good for sponsor, community, or monetization dashboards.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

Returns paginated latest Kick gifts for a channel ID.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
channelId integer

Kick channel ID for the streamer.

Ejemplo: 50291333
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 1 units Con alcance de cuenta

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

A compact metric endpoint for monetization summaries.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
channelId integer

Kick channel ID for the streamer.

Ejemplo: 50291333
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/50291333/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated ban events for the last 30 days.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de streamer

Returns moderators ranked by recorded ban activity.

A lightweight aggregate endpoint for moderation leaderboards.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated host/raid style events.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

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

Poll options are returned as parsed JSON when available.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated prediction summaries for the streamer channel.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

Returns the full ordered event history for a single prediction.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
predictionId string

Prediction identifier returned by prediction endpoints.

Ejemplo: pred_1177001
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/predictions/pred_1177001/history" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated pinned message history.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns top redeemers plus reward redemption pagination blocks.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

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

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
search string

Case-insensitive title or slug filter.

Ejemplo: ranked
startDate date

Inclusive broadcast start date filter.

Ejemplo: 2026-03-01
endDate date

Inclusive broadcast end date filter.

Ejemplo: 2026-03-22
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de streamer

Returns paginated clips for the streamer channel.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
slug string

Streamer slug assigned to the account or API key.

Ejemplo: semm_usa
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns a list of streamers similar to the supplied chatroom.

Useful for recommendation widgets or competitor discovery.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
chatroomId integer

Kick chatroom ID for the streamer.

Ejemplo: 90500123
Parámetros de consulta
limit integer

Maximum similar streamers to return.

Ejemplo: 6
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/streamers/90500123/similar?limit=6" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
    }
  ]
}

Analítica de emisiones

Endpoints de analítica, actividad, regalos y clips por emisión.

activos total
GET

Broadcast stats

/api/customer/v1/broadcasts/:broadcastId/stats
Activo 4 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/stats" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns the most active usernames inside a single broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns poll events created during the selected broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns prediction events created during the broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns pinned chat messages created during that broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns subscription events that happened during the broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
type string

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

Ejemplo: all
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns the top gifter leaderboard for a single broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 2 units Con alcance de cuenta

Returns the total Kick gifts tracked during the broadcast window.

A compact monetization metric for stream summaries and revenue dashboards.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Códigos de error
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.

Ejemplo de solicitud bash 
curl -X GET "https://kicklogz.com/api/customer/v1/broadcasts/892112233/gifts/total" \
  -H "x-kicklogz-api-key: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns the individual Kick gift events sent during a broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 4 units Con alcance de cuenta

Returns clips generated from that specific broadcast.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
broadcastId string

Broadcast identifier.

Ejemplo: 892112233
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 20
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
}

Perfiles de Kick

Endpoints centrados en el usuario para baneos, regalos, recompensas, clips e historial de nombres.

activos total
GET

Kick profile bans

/api/customer/v1/kick-profiles/:username/bans
Activo 3 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

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.

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

Returns reward redemptions performed by the target Kick user.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

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

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Activo 3 units Con alcance de cuenta

Returns clips created by the target Kick user.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 12
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta 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
Próximamente 2 units Con alcance de cuenta

Returns previous known usernames for the target Kick account.

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

Parámetros
Encabezados
x-kicklogz-api-key string

Secret KickLogz API key created in Profile > KickLogz API.

Ejemplo: klz_live_0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef
Parámetros de ruta
username string

Kick username.

Ejemplo: viewer42
Parámetros de consulta
page integer

1-based page number.

Ejemplo: 1
limit integer

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

Ejemplo: 10
Códigos de error
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.

Ejemplo de solicitud 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"
Ejemplo de respuesta text 
[object Object]