TikTok LIVE Agency SDK

Cosa fa per le agenzie

tiktok-live-agency racchiude l'API di tik.tools in un client tipizzato pensato per le agenzie TikTok LIVE (Creator Networks, TCN, MCN). Lo stesso nome di pacchetto è su npm e PyPI, ed entrambi i client condividono lo stesso elenco di metodi.

• Trova creator da reclutare. Creator in classifica per regione candidati a entrare in un'agenzia, nuovi arrivi nel bacino di reclutamento e creator che escono dalle leghe.
• Stato live e diamanti del roster. Controlla quali dei tuoi creator sono in diretta adesso e leggi i diamanti per creator e per roster, dai regali registrati durante le loro live.
• Webhook. Avvisi firmati di inizio e fine live inviati al tuo server, con un verificatore per Node, Edge, Workers e Python.
• Dashboard su misura. JSON semplice con gli stessi nomi dei campi dell'API, così i dati finiscono dritti in una pagina Next.js, in un notebook o in un export su foglio di calcolo.

Installazione

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

Imposta la tua chiave nella variabile d'ambiente TIKTOOLS_API_KEY sul server. Non inviarla mai a un browser: il client TypeScript si rifiuta di avviarsi in una pagina browser. Le chiavi sono nella pagina prezzi.

Esempi

Quali dei miei creator sono in diretta (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))

Verificare un webhook di inizio live in un Route Handler di 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')
}

Creator da reclutare e diamanti del 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"])

Una chiamata non inclusa nel tuo piano genera PlanRequiredError con il piano richiesto e un link per l'upgrade, così una dashboard può mostrare una scheda di upgrade invece di bloccarsi. Payload e firme dei webhook sono documentati nel riferimento API.

Gruppi di metodi

Python usa gli stessi nomi in snake_case, per esempio who_is_live e find_creators_to_recruit. Ogni metodo con il relativo piano è elencato nel README di ciascun pacchetto.

Per gli assistenti AI

Un riepilogo leggibile dalle macchine di ogni metodo si trova su tik.tools/sdk/agency/llms.txt. Indicalo a Cursor, Claude, ChatGPT o a qualsiasi builder AI e specifica il pacchetto tiktok-live-agency, così il codice generato usa dati reali dell'API.

Codice sorgente e pacchetti

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

Non ufficiale, non affiliato a TikTok o ByteDance. tiktok-live-agency è un SDK indipendente per l'API di tik.tools. TikTok è un marchio del rispettivo proprietario, citato qui solo per descrivere la compatibilità.