TikTok LIVE Agency SDK

Qué hace por las agencias

tiktok-live-agency envuelve la API de tik.tools en un cliente tipado pensado para agencias de TikTok LIVE (Creator Networks, TCN, MCN). El mismo nombre de paquete está en npm y PyPI, y ambos clientes comparten la misma lista de métodos.

• Encuentra creadores para reclutar. Creadores clasificados por región que son candidatos para unirse a una agencia, recién llegados al pool de reclutamiento y creadores que salen de las ligas.
• Estado en vivo y diamantes del roster. Comprueba cuáles de tus creadores están en vivo ahora mismo y consulta los diamantes por creador y por roster, a partir de los regalos captados durante sus transmisiones.
• Webhooks. Alertas firmadas de inicio y fin de LIVE enviadas a tu servidor, con un verificador para Node, Edge, Workers y Python.
• Paneles a medida. JSON simple con los mismos nombres de campo de la API, así los datos van directo a una página de Next.js, un notebook o una exportación a hoja de cálculo.

Instalación

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

Configura tu key en la variable de entorno TIKTOOLS_API_KEY del servidor. Nunca la envíes a un navegador: el cliente de TypeScript se niega a iniciar dentro de una página del navegador. Las keys están en la página de precios.

Ejemplos

Cuáles de mis creadores están en vivo (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))

Verificar un webhook de inicio de LIVE en un Route Handler de 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')
}

Creadores para reclutar y diamantes 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 llamada que tu plan no incluye lanza PlanRequiredError con el plan requerido y un enlace para mejorar, así un panel puede mostrar una tarjeta de mejora en lugar de fallar. Los payloads y las firmas de los webhooks están documentados en la referencia de la API.

Grupos de métodos

Python usa los mismos nombres en snake_case, por ejemplo who_is_live y find_creators_to_recruit. Cada método con su plan aparece en el README de cada paquete.

Para asistentes de IA

Un resumen legible por máquinas de cada método está en tik.tools/sdk/agency/llms.txt. Apunta Cursor, Claude, ChatGPT o cualquier generador con IA a ese archivo e indica el paquete tiktok-live-agency, así el código generado usa datos reales de la API.

Código fuente y paquetes

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

No oficial, sin afiliación con TikTok ni ByteDance. tiktok-live-agency es un SDK independiente para la API de tik.tools. TikTok es una marca registrada de su respectivo propietario y se usa aquí solo para describir la compatibilidad.