TikTok LIVE Agency SDK

O que ele faz pelas agências

O tiktok-live-agency envolve a API do tik.tools num cliente tipado feito para agências de TikTok LIVE (Creator Networks, TCN, MCN). O mesmo nome de pacote está no npm e no PyPI, e os dois clientes têm a mesma lista de métodos.

• Encontre criadores para recrutar. Criadores classificados por região que são candidatos a entrar numa agência, novos nomes no grupo de recrutamento e criadores saindo das ligas.
• Status ao vivo e diamantes do elenco. Veja quais dos seus criadores estão ao vivo agora e leia os diamantes por criador e por elenco, a partir dos presentes captados durante as lives.
• Webhooks. Alertas assinados de início e fim de LIVE para o seu servidor, com um verificador para Node, Edge, Workers e Python.
• Painéis personalizados. JSON puro com os mesmos nomes de campo da API, então os dados entram direto numa página Next.js, num notebook ou numa exportação para planilha.

Instalação

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

Defina sua chave na variável de ambiente TIKTOOLS_API_KEY no servidor. Nunca mande ela para o navegador: o cliente TypeScript se recusa a iniciar numa página do navegador. As chaves ficam na página de preços.

Exemplos

Quais dos meus criadores estão ao 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 um webhook de início de LIVE num Route Handler do 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')
}

Criadores para recrutar e diamantes do elenco (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"])

Uma chamada que o seu plano não inclui lança PlanRequiredError com o plano necessário e um link de upgrade, para que o painel mostre um card de upgrade em vez de quebrar. Os payloads e as assinaturas dos webhooks estão documentados na referência da API.

Grupos de métodos

O Python usa os mesmos nomes em snake_case, por exemplo who_is_live e find_creators_to_recruit. Todos os métodos e seus planos estão listados no README de cada pacote.

Para assistentes de IA

Um resumo legível por máquina de todos os métodos fica em tik.tools/sdk/agency/llms.txt. Aponte o Cursor, Claude, ChatGPT ou qualquer criador de apps com IA para ele e indique o pacote tiktok-live-agency, para que o código gerado use dados reais da API.

Código-fonte e pacotes

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

Não oficial, sem vínculo com o TikTok ou a ByteDance. O tiktok-live-agency é um SDK independente para a API do tik.tools. TikTok é uma marca registrada do respectivo dono, usada aqui só para descrever compatibilidade.