TikTok LIVE Agency SDK

SDK làm được gì cho agency

tiktok-live-agency bọc API của tik.tools trong một client có kiểu dữ liệu, xây riêng cho agency TikTok LIVE (Creator Networks, TCN, MCN). Cùng một tên gói trên npm và PyPI, và cả hai client dùng chung một danh sách phương thức.

• Tìm nhà sáng tạo để tuyển. Nhà sáng tạo được xếp hạng theo khu vực là ứng viên vào agency, người mới vào nhóm tuyển, và nhà sáng tạo đang rớt khỏi giải đấu.
• Trạng thái live và kim cương của danh sách idol. Xem idol nào của bạn đang live ngay lúc này, và đọc số kim cương theo từng người và theo cả danh sách từ quà ghi nhận được trong các phiên live.
• Webhook. Cảnh báo lên live và kết thúc live có chữ ký gửi tới server của bạn, kèm hàm xác minh cho Node, Edge, Workers và Python.
• Dashboard tùy chỉnh. JSON thuần với đúng tên trường của API, nên dữ liệu đưa thẳng vào một trang Next.js, notebook hoặc file xuất bảng tính.

Cài đặt

JavaScript và 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]"

Đặt key vào biến môi trường TIKTOOLS_API_KEY trên server. Không bao giờ đưa key ra trình duyệt: client TypeScript từ chối khởi động trong trang trình duyệt. Key có trên trang bảng giá.

Ví dụ

Idol nào của tôi đang 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))

Xác minh webhook lên live trong Next.js Route Handler (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')
}

Nhà sáng tạo để tuyển và kim cương của danh sách (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"])

Lệnh gọi không có trong gói của bạn sẽ ném PlanRequiredError kèm gói cần có và link nâng cấp, để dashboard hiện thẻ nâng cấp thay vì bị lỗi. Payload và chữ ký webhook được mô tả trong tài liệu tham chiếu API.

Nhóm phương thức

Python dùng cùng tên ở dạng snake_case, ví dụ who_is_live và find_creators_to_recruit. Mọi phương thức cùng gói tương ứng đều được liệt kê trong README của từng gói.

Cho trợ lý AI

Bản tóm tắt máy đọc được của mọi phương thức nằm ở tik.tools/sdk/agency/llms.txt. Trỏ Cursor, Claude, ChatGPT hoặc bất kỳ công cụ AI nào tới đó, và gọi đúng tên gói tiktok-live-agency, để code được tạo dùng dữ liệu thật từ API.

Mã nguồn và gói

• TypeScript: github.com/tiktool/tiktok-live-agency và npm
• Python: github.com/tiktool/tiktok-live-agency-python và PyPI
• Giấy phép: MIT

Không chính thức, không liên kết với TikTok hay ByteDance. tiktok-live-agency là SDK độc lập cho API của tik.tools. TikTok là nhãn hiệu của chủ sở hữu tương ứng, chỉ được dùng ở đây để mô tả khả năng tương thích.