TikTok LIVE Agency SDK

Was es für Agenturen kann

tiktok-live-agency verpackt die tik.tools API in einen typisierten Client, gebaut für TikTok-LIVE-Agenturen (Creator Networks, TCN, MCN). Derselbe Paketname liegt auf npm und PyPI, und beide Clients haben dieselbe Methodenliste.

• Creator zum Rekrutieren finden. Gerankte Creator pro Region, die als Kandidaten für eine Agentur infrage kommen, Neuzugänge im Recruiting-Pool und Creator, die aus den Ligen fallen.
• Live-Status und Diamanten des Rosters. Prüf, welche deiner Creator gerade live sind, und lies die Diamanten pro Creator und pro Roster aus den Geschenken, die während ihrer Streams erfasst wurden.
• Webhooks. Signierte Alerts bei Go-Live und Stream-Ende an deinen Server, mit einem Verifier für Node, Edge, Workers und Python.
• Eigene Dashboards. Schlichtes JSON mit den Feldnamen der API, damit die Daten direkt in eine Next.js-Seite, ein Notebook oder einen Tabellenexport passen.

Installation

JavaScript und TypeScript

npm install tiktok-live-agency

Python

pip install tiktok-live-agency

# optional, for the real-time big gifts stream
pip install "tiktok-live-agency[realtime]"

Leg deinen Key auf dem Server in der Umgebungsvariable TIKTOOLS_API_KEY ab. Schick ihn nie an einen Browser: Der TypeScript-Client startet in einer Browserseite gar nicht erst. Keys gibt es auf der Preisseite.

Beispiele

Welche meiner Creator sind live (TypeScript)

import { AgencyClient } from 'tiktok-live-agency'

const tt = new AgencyClient() // reads TIKTOOLS_API_KEY

const { live, offline, unknown } = await tt.whoIsLive(['creator_one', 'creator_two', 'creator_three'])
console.log(live.map((r) => r.unique_id))

Go-Live-Webhook in einem Next.js Route Handler verifizieren (TypeScript)

// app/api/webhooks/tiktools/route.ts
import { verifyWebhook } from 'tiktok-live-agency/webhooks'

export async function POST(req: Request) {
  const raw = await req.text() // raw body, verify before parsing
  try {
    const event = await verifyWebhook(raw, req.headers, process.env.TIKTOOLS_WEBHOOK_SECRET!)
    console.log(event.event, event.creator.unique_id)
  } catch {
    return new Response('bad signature', { status: 400 })
  }
  return new Response('ok')
}

Creator zum Rekrutieren und Roster-Diamanten (Python)

from tiktok_live_agency import AgencyClient, is_free_to_join

tt = AgencyClient()  # reads TIKTOOLS_API_KEY

rows = list(tt.iter_creators_to_recruit("UK", max_pages=5))
free = [r for r in rows if is_free_to_join(r)]

roster = tt.list_rosters()["lists"][0]
week = tt.roster_diamonds(roster["id"], days=7)
print(len(free), week["totalDiamonds"])

Ein Aufruf, den dein Tarif nicht enthält, wirft PlanRequiredError mit dem nötigen Tarif und einem Upgrade-Link, damit ein Dashboard eine Upgrade-Karte zeigen kann, statt abzustürzen. Webhook-Payloads und Signaturen sind in der API-Referenz dokumentiert.

Methodengruppen

Python nutzt dieselben Namen in snake_case, zum Beispiel who_is_live und find_creators_to_recruit. Jede Methode mit ihrem Tarif steht in der README des jeweiligen Pakets.

Für KI-Assistenten

Eine maschinenlesbare Übersicht aller Methoden liegt unter tik.tools/sdk/agency/llms.txt. Verweis Cursor, Claude, ChatGPT oder einen anderen KI-Builder darauf und nenn das Paket tiktok-live-agency, damit generierter Code echte Daten aus der API nutzt.

Quellcode und Pakete

• TypeScript: github.com/tiktool/tiktok-live-agency und npm
• Python: github.com/tiktool/tiktok-live-agency-python und PyPI
• Lizenz: MIT

Inoffiziell, nicht mit TikTok oder ByteDance verbunden. tiktok-live-agency ist ein unabhängiges SDK für die tik.tools API. TikTok ist eine Marke des jeweiligen Inhabers und wird hier nur zur Beschreibung der Kompatibilität verwendet.