TikTok LIVE SDK Agency

Apa manfaatnya untuk agency

tiktok-live-agency membungkus API tik.tools dalam client bertipe yang dibuat untuk agency TikTok LIVE (Creator Networks, TCN, MCN). Nama paketnya sama di npm dan PyPI, dan kedua client memakai daftar method yang sama.

• Cari kreator untuk direkrut. Kreator berperingkat per wilayah yang jadi kandidat untuk gabung agency, pendatang baru di pool rekrutmen, dan kreator yang keluar dari liga.
• Status live dan berlian roster. Cek kreator mana saja yang sedang live sekarang, dan baca berlian per kreator dan per roster dari hadiah yang tercatat selama siaran mereka.
• Webhook. Notifikasi mulai live dan siaran berakhir yang ditandatangani, dikirim ke server kamu, dengan verifier untuk Node, Edge, Workers, dan Python.
• Dasbor kustom. JSON biasa dengan nama field asli dari API, jadi datanya langsung bisa dipakai di halaman Next.js, notebook, atau ekspor spreadsheet.

Instalasi

JavaScript dan 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]"

Simpan key kamu di environment variable TIKTOOLS_API_KEY di server. Jangan pernah mengirimnya ke browser: client TypeScript menolak berjalan di halaman browser. Key tersedia di halaman harga.

Contoh

Kreator mana saja yang sedang 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))

Verifikasi webhook mulai live di Route Handler Next.js (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')
}

Kreator untuk direkrut dan berlian roster (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"])

Panggilan yang tidak termasuk dalam paket kamu akan melempar PlanRequiredError beserta paket yang dibutuhkan dan link upgrade, jadi dasbor bisa menampilkan kartu upgrade alih-alih crash. Payload dan signature webhook didokumentasikan di referensi API.

Grup method

Python memakai nama yang sama dalam snake_case, misalnya who_is_live dan find_creators_to_recruit. Setiap method beserta paketnya tercantum di README masing-masing paket.

Untuk asisten AI

Ringkasan setiap method yang bisa dibaca mesin tersedia di tik.tools/sdk/agency/llms.txt. Arahkan Cursor, Claude, ChatGPT, atau AI builder apa pun ke sana, dan sebutkan nama paketnya tiktok-live-agency, supaya kode yang dihasilkan memakai data asli dari API.

Kode sumber dan paket

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

Tidak resmi, tidak berafiliasi dengan TikTok atau ByteDance. tiktok-live-agency adalah SDK independen untuk API tik.tools. TikTok adalah merek dagang milik pemiliknya masing-masing, digunakan di sini hanya untuk menjelaskan kompatibilitas.