TikTok LIVE SDK Agency

Ce qu'il apporte aux agences

tiktok-live-agency encapsule l'API tik.tools dans un client typé conçu pour les agences TikTok LIVE (Creator Networks, TCN, MCN). Le même nom de package existe sur npm et PyPI, et les deux clients partagent la même liste de méthodes.

• Trouve des créateurs à recruter. Les créateurs classés par région susceptibles de rejoindre une agence, les nouveaux arrivants dans le vivier de recrutement et les créateurs qui sortent des ligues.
• Statut live et diamants de l'équipe. Vois lesquels de tes créateurs sont en live en ce moment, et consulte les diamants par créateur et par équipe, calculés à partir des cadeaux captés pendant leurs streams.
• Webhooks. Des alertes signées de passage en LIVE et de fin de stream envoyées à ton serveur, avec un vérificateur pour Node, Edge, Workers et Python.
• Tableaux de bord sur mesure. Du JSON brut avec les noms de champs de l'API, pour que les données s'intègrent directement dans une page Next.js, un notebook ou un export tableur.

Installation

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

Définis ta clé dans la variable d'environnement TIKTOOLS_API_KEY côté serveur. Ne l'envoie jamais dans un navigateur : le client TypeScript refuse de démarrer dans une page web. Les clés sont sur la page des tarifs.

Exemples

Lesquels de mes créateurs sont en 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))

Vérifier un webhook de passage en LIVE dans 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')
}

Créateurs à recruter et diamants de l'équipe (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 appel que ton offre n'inclut pas lève PlanRequiredError avec l'offre requise et un lien de mise à niveau, pour qu'un tableau de bord affiche une carte d'upgrade au lieu de planter. Les payloads et signatures des webhooks sont documentés dans la référence de l'API.

Groupes de méthodes

Python utilise les mêmes noms en snake_case, par exemple who_is_live et find_creators_to_recruit. Chaque méthode et l'offre requise sont listées dans le README de chaque package.

Pour les assistants IA

Un résumé lisible par machine de chaque méthode se trouve sur tik.tools/sdk/agency/llms.txt. Indique-le à Cursor, Claude, ChatGPT ou n'importe quel outil de génération IA, et précise le package tiktok-live-agency, pour que le code généré utilise les vraies données de l'API.

Code source et packages

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

Non officiel, sans lien avec TikTok ou ByteDance. tiktok-live-agency est un SDK indépendant pour l'API tik.tools. TikTok est une marque de son propriétaire respectif, citée ici uniquement pour décrire la compatibilité.