For developers

Build bots, integrations, and embeds on the public LookCam API. Below you'll find the basics — the full contract is described by the OpenAPI specification.

OpenAPI specification

Full description of endpoints, models, and responses: download lookcam.openapi.yaml. Import it into Postman, Insomnia, or Scalar, or generate a client (e.g. openapi-typescript, oapi-codegen). You'll find the API changelog in the API changelog.

Base URL and versioning

All endpoints are under https://api.lookcam.com/v1.

Authentication

Personal access token (PAT) — the simplest option for bots/servers. Generate one in Settings → Developer and send the header Authorization: Bearer <token>. Scopes: chat:read, chat:send.
Cookie (web) — browser session (HttpOnly), used by the web app.

Rate limits

Endpoints are rate-limited per key/IP. Once exceeded you'll get a 429 with a Retry-After header — wait and retry. Design your integration with exponential backoff.

Chat bots

With a token scoped to chat:send/chat:read use POST /v1/bot/messages and GET /v1/bot/messages (see the specification for details).

SDK and examples

Generate a typed client straight from the OpenAPI specification (recommended), e.g. for TypeScript:

npx openapi-typescript https://lookcam.com/openapi/lookcam.openapi.yaml -o lookcam.d.ts

Example: a simple chat bot using a personal token (PAT, chat:send scope):

const API = 'https://api.lookcam.com/v1'
const TOKEN = process.env.LOOKCAM_TOKEN // PAT z Ustawienia → Deweloper

await fetch(API + '/bot/messages', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ channel: 'twoj_kanal', message: 'Cześć z bota!' }),
})

Webhooks

Event subscriptions (stream.started/ended, follow, subscription, chat) with HMAC signing and retries — coming soon. Check back here.

Embedding

Embed the player and live chat via iframe — see the embedding docs + code generator.

By using the API you accept the acceptable use policy.