TikTok LIVE Agency SDK

Ce face pentru agenții

tiktok-live-agency încapsulează API-ul tik.tools într-un client tipizat, construit pentru agențiile TikTok LIVE (Creator Networks, TCN, MCN). Același nume de pachet există pe npm și PyPI, iar ambii clienți au aceeași listă de metode.

• Găsește creatori de recrutat. Creatori clasați pe regiuni care sunt candidați să se alăture unei agenții, noii veniți în lista de recrutare și creatorii care ies din ligi.
• Statusul LIVE și diamantele portofoliului. Verifică care dintre creatorii tăi sunt LIVE chiar acum și citește diamantele pe creator și pe portofoliu, din cadourile capturate în timpul transmisiunilor lor.
• Webhook-uri. Alerte semnate la intrarea LIVE și la încheierea transmisiunii, trimise către serverul tău, cu un verificator pentru Node, Edge, Workers și Python.
• Panouri personalizate. JSON simplu, cu numele de câmpuri ale API-ului, astfel încât datele intră direct într-o pagină Next.js, într-un notebook sau într-un export de foaie de calcul.

Instalare

JavaScript și 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]"

Setează cheia în variabila de mediu TIKTOOLS_API_KEY pe server. Nu o trimite niciodată într-un browser: clientul TypeScript refuză să pornească într-o pagină de browser. Cheile se găsesc pe pagina de prețuri.

Exemple

Care dintre creatorii mei sunt 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))

Verifică un webhook de intrare LIVE într-un 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')
}

Creatori de recrutat și diamantele portofoliului (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"])

Un apel pe care planul tău nu îl include aruncă PlanRequiredError cu planul necesar și un link de upgrade, astfel încât un panou poate afișa un card de upgrade în loc să se blocheze. Payload-urile și semnăturile webhook-urilor sunt documentate în referința API.

Grupuri de metode

Python folosește aceleași nume în snake_case, de exemplu who_is_live și find_creators_to_recruit. Fiecare metodă, împreună cu planul ei, este listată în README-ul fiecărui pachet.

Pentru asistenții AI

Un rezumat al tuturor metodelor, citibil automat, se află la tik.tools/sdk/agency/llms.txt. Îndreaptă Cursor, Claude, ChatGPT sau orice alt instrument AI către el și numește pachetul tiktok-live-agency, ca să folosească în codul generat date reale din API.

Cod sursă și pachete

• TypeScript: github.com/tiktool/tiktok-live-agency și npm
• Python: github.com/tiktool/tiktok-live-agency-python și PyPI
• Licență: MIT

Neoficial, neafiliat cu TikTok sau ByteDance. tiktok-live-agency este un SDK independent pentru API-ul tik.tools. TikTok este o marcă comercială a proprietarului său și este folosită aici doar pentru a descrie compatibilitatea.