TikTok LIVE API

ما هي TikTok LIVE API؟

لا يوفر تيك توك واجهة API عامة لبيانات البث المباشر مثل الدردشة والهدايا وعدد المشاهدين. واجهة TikTok Business API تغطي الإعلانات وتحليلات المتجر فقط. وللوصول إلى بيانات LIVE لحظة بلحظة، يستخدم المطورون واجهات API من جهات خارجية.

المكتبتان مفتوحتا المصدر tiktok-live-connector (لـ Node.js) و TikTokLive (لـ Python) مرخصتان بترخيص MIT ومجانيتان. تعتمدان على خادم خلفي لتوقيع طلبات تيك توك، وأحد الخيارات الافتراضية تاريخيًا خدمة توقيع مدفوعة يطورها الفريق نفسه الذي يدير هاتين المكتبتين.

TikTool بديل مستقل ولديه بنية توقيع خاصة به، وهو واجهة API مُدارة بالكامل: نتولى من جهتنا استمرارية الاتصال والمصادقة. اتصال WebSocket واحد يوصل 90+ نوعًا من الأحداث: الدردشة والهدايا والإعجابات والمتابعات والمشاهدين والمباريات وغيرها. حزم SDK رسمية لـ Node.js و Python. باقة Sandbox بدون بطاقة ائتمان.

كيف تعمل TikTok LIVE API؟

يقع TikTool بين تطبيقك وبنية البث المباشر في تيك توك. وهذه آلية العمل:

لن تتعامل مع بروتوكول تيك توك مباشرة أبدًا. عندما يغيّر تيك توك أنظمته الداخلية (وهذا يحدث كثيرًا)، يتكيف TikTool ويستمر كودك في العمل دون أي تغيير.

بداية سريعة: Node.js / TypeScript

ثبّت حزمة SDK الرسمية من npm:

npm install @tiktool/live

اتصل ببث مباشر واستقبل الأحداث:

import { TikTokLive } from '@tiktool/live';

const client = new TikTokLive({
  uniqueId: 'streamer_username',
  apiKey: 'YOUR_API_KEY' // Get free key → https://tik.tools
});

client.on('chat', (event) => {
  console.log(`${event.user.uniqueId}: ${event.comment}`);
});

client.on('gift', (event) => {
  console.log(`${event.user.uniqueId} sent ${event.giftName} (${event.diamondCount} diamonds)`);
});

client.on('roomUserSeq', (event) => {
  console.log(`${event.viewerCount} viewers watching`);
});

client.connect();

دعم كامل لـ TypeScript: كل نوع حدث وكل حقل ومعامل محدد الأنواع بالكامل مع إكمال تلقائي في محرر الكود. اقرأ دليل Node.js الكامل →

بداية سريعة: Python

التثبيت من PyPI:

pip install tiktok-live-api

اتصل عبر SDK وسجّل المعالجات باستخدام decorators:

from tiktok_live_api import TikTokLive

client = TikTokLive("streamer_username", api_key="YOUR_API_KEY")  # Get free key at https://tik.tools

@client.on("chat")
def on_chat(event):
    print(f"{event['user']['uniqueId']}: {event['comment']}")

@client.on("gift")
def on_gift(event):
    print(f"{event['user']['uniqueId']} sent {event['giftName']} ({event['diamondCount']} diamonds)")

@client.on("roomUserSeq")
def on_viewers(event):
    print(f"{event['viewerCount']} viewers watching")

client.run()  # blocks; reconnects automatically

تفضّل asyncio؟ await client.connect() يشغّل العميل نفسه داخل حلقة الأحداث الخاصة بك. ويمكن أيضًا قراءة المفتاح من متغير البيئة TIKTOOL_API_KEY.

اقرأ دليل Python الكامل →

بداية سريعة: WebSocket مباشر (أي لغة)

تعمل أي لغة تدعم WebSocket، مثل Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. فقط اتصل بـ:

wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEY

كل رسالة كائن JSON يحتوي على الحقلين event و data. بيانات نظيفة ومنظمة، بدون أي تحليل ثنائي. مرجع WebSocket API الكامل →

كل أنواع الأحداث

تبث TikTok LIVE API أكثر من 18 حدثًا لحظة بلحظة من أي بث مباشر:

اطّلع على مرجع الأحداث الكامل مع أمثلة للبيانات →

ماذا يمكنك أن تبني؟

اطّلع على المزيد من الاستخدامات →

TikTool مقابل Euler Stream مقابل tiktok-live-connector

المكتبتان مفتوحتا المصدر tiktok-live-connector (لـ Node.js) و TikTokLive (لـ Python) يديرهما الفريق نفسه الذي يشغّل Euler Stream. ومعًا تشكّل منظومة مدعومة جيدًا بعملاء مرخصين بترخيص MIT وخادم توقيع مُدار. أما TikTool فبديل مستقل ومُدار ببنية توقيع خاصة به وتركيز مختلف في الميزات.

الأسعار والباقة المجانية

ابدأ البناء على TikTok LIVE API مجانًا. بدون بطاقة ائتمان.

الأسئلة الشائعة