TikTok LIVE Agency SDK

Τι κάνει για τα agencies

Το tiktok-live-agency τυλίγει το API του tik.tools σε έναν typed client φτιαγμένο για agencies του TikTok LIVE (Creator Networks, TCN, MCN). Το ίδιο όνομα πακέτου υπάρχει σε npm και PyPI, και οι δύο clients μοιράζονται την ίδια λίστα μεθόδων.

• Βρες creators για recruit. Ταξινομημένοι creators ανά περιοχή που είναι υποψήφιοι για agency, νέες αφίξεις στο pool του recruit και creators που βγαίνουν από τις λίγκες.
• Κατάσταση live και διαμάντια του ρόστερ. Δες ποιοι από τους creators σου είναι live αυτή τη στιγμή και διάβασε τα διαμάντια ανά creator και ανά ρόστερ, από τα δώρα που καταγράφηκαν στα streams τους.
• Webhooks. Υπογεγραμμένες ειδοποιήσεις για έναρξη και λήξη live στον server σου, με verifier για Node, Edge, Workers και Python.
• Δικά σου dashboards. Σκέτο JSON με τα ίδια ονόματα πεδίων του API, οπότε τα δεδομένα μπαίνουν κατευθείαν σε μια σελίδα Next.js, σε ένα notebook ή σε export για spreadsheet.

Εγκατάσταση

JavaScript και 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]"

Βάλε το key σου στη μεταβλητή περιβάλλοντος TIKTOOLS_API_KEY στον server. Μην το στέλνεις ποτέ σε browser: ο TypeScript client αρνείται να ξεκινήσει μέσα σε σελίδα browser. Τα keys βρίσκονται στη σελίδα τιμών.

Παραδείγματα

Ποιοι από τους creators μου είναι 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))

Επαλήθευση webhook έναρξης live σε 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')
}

Creators για recruit και διαμάντια ρόστερ (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"])

Μια κλήση που δεν περιλαμβάνει το πακέτο σου πετάει PlanRequiredError με το απαιτούμενο πακέτο και ένα link αναβάθμισης, ώστε ένα dashboard να δείξει κάρτα αναβάθμισης αντί να κρασάρει. Τα payloads και οι υπογραφές των webhooks περιγράφονται στην αναφορά API.

Ομάδες μεθόδων

Η Python χρησιμοποιεί τα ίδια ονόματα σε snake_case, για παράδειγμα who_is_live και find_creators_to_recruit. Κάθε μέθοδος μαζί με το πακέτο της αναφέρεται στο README κάθε πακέτου.

Για AI assistants

Μια περίληψη κάθε μεθόδου σε μορφή για μηχανές βρίσκεται στο tik.tools/sdk/agency/llms.txt. Δείξ' τη στο Cursor, στο Claude, στο ChatGPT ή σε οποιοδήποτε AI builder και ανέφερε το πακέτο tiktok-live-agency, ώστε ο κώδικας που παράγεται να χρησιμοποιεί πραγματικά δεδομένα από το API.

Κώδικας και πακέτα

• TypeScript: github.com/tiktool/tiktok-live-agency και npm
• Python: github.com/tiktool/tiktok-live-agency-python και PyPI
• Άδεια: MIT

Ανεπίσημο, χωρίς σχέση με το TikTok ή την ByteDance. Το tiktok-live-agency είναι ανεξάρτητο SDK για το API του tik.tools. Το TikTok είναι εμπορικό σήμα του αντίστοιχου κατόχου του και αναφέρεται εδώ μόνο για να περιγράψει τη συμβατότητα.