آخر تحديث
صنّاع المحتوى
ملفات صنّاع المحتوى المحفوظة، والتغييرات، وشبكة المتابعة، والتحليلات.
تُصادَق كل عملية بمفتاح API (Authorization: Bearer <key>) وتستخدم الأخطاء الغلاف المشترك الموضّح في الأخطاء. مولَّد من مستند OpenAPI الخاص بواجهة API.
عرض وكالات TikTok LIVE
/v1/agenciesوكالات TikTok LIVE (من ملفاتها التعريفية العامة كوكالات)، يمكن البحث فيها بالاسم أو باسم المستخدم الرسمي، وحسب المنطقة ووجود ملف تعريفي عام، مع الترتيب حسب الحجم (hostCountMin) أو فئة الإيرادات (monthlyDiamondMin) أو الأحدث أو الاسم. الفئات هي نطاقات TikTok نفسها. تعرض بيانات الاتصال ما نشرته الوكالة فقط.
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
qOptional | string | جزء من اسم الوكالة، أو اسم المستخدم الرسمي لها. |
regionOptional | string | مجموعة المناطق (مثل VN وUS+ وMENA). |
publicOnlyOptional | boolean | الوكالات التي لديها ملف تعريفي عام فقط. |
sortOptional | "size" | "revenue" | "recent" | "name" | size أو revenue أو recent أو name.Default: size |
limitOptional | integer | الحد الأقصى لعدد الصفوف. المدى …–200. Default: 50 |
offsetOptional | integer | عدد الصفوف المراد تخطيها. Default: 0 |
الطلب
curl "https://api.next.toktokdata.live/v1/agencies" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "agencies": [ { "agencyId": "108474", "name": "Look Corporation", "regions": [ "KR" ], "onboardedOn": "2025-03-01", "official": { "uid": "7012345678901234567", "handle": "look.corp", "nickname": "Look Corporation", "avatarUrl": null, "followers": 12500 }, "intro": "A TikTok LIVE agency based in Korea.", "services": [ "1_on_1_support", "live_skills_training" ], "contact": { "website": "https://example.com" }, "hostCountBand": "101-200", "agentCountBand": "11-50", "monthlyDiamondBand": "1M-5M", "hostCountMin": 101, "monthlyDiamondMin": 1000000, "hasPublicProfile": true, "lastSeenAt": "2026-10-24T05:34:33.738Z" } ], "total": 1, "offset": 0 }, "provenance": { "observedAt": "2026-10-24T05:34:33.738Z", "freshness": "stale", "source": "public_creator_profile", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "agency-directory-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب وكالة TikTok LIVE
/v1/agencies/{agency_id}وكالة واحدة من الدليل، كما يعرضها GET /v1/agencies.
معاملات المسار
| Name | Type | Description |
|---|---|---|
agency_idRequired | string | معرّف الوكالة على TikTok. |
الطلب
curl "https://api.next.toktokdata.live/v1/agencies/agency_id" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "agencyId": "108474", "name": "Look Corporation", "regions": [ "KR" ], "onboardedOn": "2025-03-01", "official": { "uid": "7012345678901234567", "handle": "look.corp", "nickname": "Look Corporation", "avatarUrl": null, "followers": 12500 }, "intro": "A TikTok LIVE agency based in Korea.", "services": [ "1_on_1_support", "live_skills_training" ], "contact": { "website": "https://example.com" }, "hostCountBand": "101-200", "agentCountBand": "11-50", "monthlyDiamondBand": "1M-5M", "hostCountMin": 101, "monthlyDiamondMin": 1000000, "hasPublicProfile": true, "lastSeenAt": "2026-10-24T05:34:33.738Z" }, "provenance": { "observedAt": "2026-10-24T05:34:33.738Z", "freshness": "stale", "source": "public_creator_profile", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "agency-directory-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
البحث عن صنّاع المحتوى
/v1/creatorsجزء من اسم المستخدم أو الاسم المعروض، دون تمييز لحالة الأحرف، والأكثر متابعة أولًا. وتؤدي قيمة q الفارغة إلى تصفّح المجموعة المحفوظة.
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
qOptional | string | اسم المستخدم (مع @ أو بدونها) أو جزء من الاسم المعروض. |
limitOptional | integer | الحد الأقصى لعدد النتائج. المدى 1–100. Default: 20 |
الطلب
curl "https://api.next.toktokdata.live/v1/creators" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "query": "linh.live", "results": [ { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "displayName": "Linh Live", "region": "VN", "avatarUrl": null, "followerCount": 123456, "verified": true } ] }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_creator_profile", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "creators-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب ملف صانع محتوى
/v1/creators/{uid}الملف العام المحفوظ وسجل عداداته الأخير. يُبحث في TikTok عن صانع محتوى لم يُحفظ بعد (أو حُفظ منذ زمن): إذا استغرق ذلك أكثر من بضع ثوانٍ فالإجابة 202 مع status: resolving وjobId وretryAfterSeconds (وكذلك Retry-After)؛ اسأل مجددًا حينها وسيكون الملف موجودًا. status: saturated (202) تعني أن عمليات البحث كثيرة جدًا؛ والمعرّف الذي لا يعرفه TikTok يُعيد 404 ولا يُبحث عنه مجددًا لعشر دقائق؛ و503 resolve_unavailable تعني أن TikTok لا يمكن قراءته الآن.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "creator": { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "secUid": null, "displayName": "Linh Live", "region": "VN", "language": null, "signature": "Daily LIVE from Hanoi", "avatarUrl": null, "followerCount": 123456, "followingCount": 321, "awemeCount": 3, "totalFavorited": 9876543, "favoritingCount": null, "verified": true, "customVerify": null, "enterpriseVerifyReason": null, "instagramId": null, "youtubeChannelId": null, "twitterId": null, "firstSeenAt": "2026-10-02T10:51:44.935Z", "lastRefreshedAt": "2026-11-01T10:36:44.935Z", "history": [] } }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_creator_profile", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "creators-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
تحليل فيديوهات صانع محتوى
/v1/creators/{uid}/analysisتقرير تفاعل محسوب من الفيديوهات المحفوظة فقط: المجاميع والوسيطات ووتيرة النشر. read حتى خمس جمل بسيطة، الأهم أولًا، كل منها code (engagement وreach وgrowth وcadence وposting-gap وbreakout وaudience-language) مع params ليصوغها العميل بلغته؛ وlimits تذكر ما لا يغطيه التقرير ولماذا تغيب جملة ما.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/analysis" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "creator": { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "displayName": "Linh Live", "avatarUrl": null, "region": "VN", "verified": true, "followerCount": 123456, "followingCount": 321, "awemeCount": 3, "totalFavorited": 9876543, "firstSeenAt": "2026-10-02T10:51:44.935Z", "lastRefreshedAt": "2026-11-01T10:36:44.935Z" }, "sample": { "videosAnalyzed": 3, "oldestVideoAt": "2026-10-29T10:51:44.935Z", "newestVideoAt": "2026-10-31T10:51:44.935Z", "spanDays": 2, "shareOfCatalog": 1 }, "engagement": { "totalPlays": 60000, "totalLikes": 6000, "totalComments": 600, "totalShares": 0, "avgPlays": 20000, "medianPlays": 20000, "avgLikes": 2000, "avgComments": 200, "avgShares": 0, "engagementRate": 0.11, "likeRate": 0.1, "commentRate": 0.01, "shareRate": 0, "viewsPerFollower": 0.162 }, "read": [ { "code": "engagement", "params": { "rate": 0.11, "band": "typical" } }, { "code": "reach", "params": { "ratio": 0.162, "band": "most-followers" } }, { "code": "growth", "params": { "delta": 1840, "rate": 0.0371, "days": 29.8, "direction": "up" } }, { "code": "cadence", "params": { "postsPerWeek": 7, "busiestWeekday": 4 } } ], "cadence": { "postsPerWeek": 7, "avgDaysBetweenPosts": 1, "longestGapDays": 1, "busiestWeekday": 4, "postsByWeekday": [ 0, 0 ] }, "topByPlays": [ { "videoId": "7990000000000000003", "description": "Video 3", "createTime": "2026-10-29T10:51:44.935Z", "playCount": 30000, "diggCount": 3000, "commentCount": 300, "shareCount": null, "engagementRate": 0.11 }, { "videoId": "7990000000000000002", "description": "Video 2", "createTime": "2026-10-30T10:51:44.935Z", "playCount": 20000, "diggCount": 2000, "commentCount": 200, "shareCount": null, "engagementRate": 0.11 } ], "topByEngagement": [ { "videoId": "7990000000000000001", "description": "Video 1", "createTime": "2026-10-31T10:51:44.935Z", "playCount": 10000, "diggCount": 1000, "commentCount": 100, "shareCount": null, "engagementRate": 0.11 }, { "videoId": "7990000000000000002", "description": "Video 2", "createTime": "2026-10-30T10:51:44.935Z", "playCount": 20000, "diggCount": 2000, "commentCount": 200, "shareCount": null, "engagementRate": 0.11 } ], "audience": null, "growth": null, "limits": [ { "code": "thin-video-sample", "message": "Only 3 video(s) analysed — too few to describe the account's typical performance." }, { "code": "single-observation", "message": "This account has been observed only once, so no follower growth can be shown yet." } ] }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "derived_creator_analysis", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "analysis-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
عرض تغييرات الملف الشخصي
/v1/creators/{uid}/changesتغييرات اسم المستخدم والاسم والنبذة والتوثيق المرصودة بمرور الوقت، من الأحدث إلى الأقدم.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
limitOptional | integer | الحد الأقصى لعدد التغييرات. المدى 1–200. Default: 50 |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/changes" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "changes": [] }, "provenance": { "observedAt": "2026-10-02T10:51:44.935Z", "freshness": "stale", "source": "public_creator_profile", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "creators-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
عرض متابعي صانع محتوى
/v1/creators/{uid}/followersالمتابعون المحفوظون، بالبنية نفسها المستخدمة للحسابات المتابَعة.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
cursorOptional | string | مؤشر معتم مأخوذ من nextCursor في الصفحة السابقة. |
limitOptional | integer | عدد الإدخالات في كل صفحة. |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/followers" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "direction": "following", "entries": [], "nextCursor": null, "hasMore": false, "totalReported": null, "storedCount": 0, "isPrivate": false }, "provenance": { "observedAt": "2026-11-01T11:18:49.084Z", "freshness": "stale", "source": "public_follow_graph", "sourceKind": "derived", "coverageStatus": "not-covered", "methodologyVersion": "follow-list-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
عرض الحسابات التي يتابعها صانع محتوى
/v1/creators/{uid}/followingشبكة المتابعة المحفوظة. تُرجع الحسابات الخاصة isPrivate: true دون أي إدخالات.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
cursorOptional | string | مؤشر معتم مأخوذ من nextCursor في الصفحة السابقة. |
limitOptional | integer | عدد الإدخالات في كل صفحة. |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/following" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "direction": "following", "entries": [], "nextCursor": null, "hasMore": false, "totalReported": null, "storedCount": 0, "isPrivate": false }, "provenance": { "observedAt": "2026-11-01T11:18:49.084Z", "freshness": "stale", "source": "public_follow_graph", "sourceKind": "derived", "coverageStatus": "not-covered", "methodologyVersion": "follow-list-v1", "window": null }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب أبرز الداعمين لصانع محتوى
/v1/creators/{uid}/giftersالداعمون في غرف LIVE الخاصة بصانع المحتوى خلال آخر 7 أو 30 يومًا، مرتّبون حسب الماسات: عدد الهدايا، والجلسات، وآخر هدية، وصانع المحتوى صاحب آخر غرفة أرسلوا فيها هدية. تُقرأ البيانات من الجلسات التي سجّلها RoomScope، لذا تكون التغطية دائمًا partial. يتطلب باقة Pro أو أعلى.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
windowOptional | "7d" | "30d" | 7d أو 30d.Default: 7d |
limitOptional | integer | الحد الأقصى لعدد الصفوف. المدى …–100. Default: 20 |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/gifters" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "creatorUid": "7012345678901234567", "uniqueId": "linh.live", "window": "7d", "gifters": [ { "gifterUserId": "6987001122334455667", "gifterUniqueId": "minh.fan", "gifterNickname": "Minh", "avatarUrl": null, "diamondTotal": 18450, "giftCount": 312, "sessions": 4, "lastGiftAt": "2026-11-02T15:41:07.512Z", "lastRoomCreator": "linh.live" } ] }, "provenance": { "observedAt": "2026-11-02T15:41:07.512Z", "freshness": "historical", "source": "platform_observed_gifter_events", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "gifters-observed-v1", "window": { "from": "2026-10-27T04:00:00.000Z", "to": "2026-11-03T04:00:00.000Z", "label": "7d" } }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب رؤى صانع محتوى
/v1/creators/{uid}/insightsسجل أسماء المستخدم، والماسات اليومية لآخر 30 يومًا (من الأحدث إلى الأقدم)، ولقطات الدوري اليومية، وغرفة LIVE الخاصة بصانع المحتوى. تكون قيمة liveExact هي true عندما تُقرأ نقاط اليوم عند إعادة ضبط لوحة التصنيف؛ وإلا فإن liveScore هي أعلى نقاط قُرئت في ذلك اليوم. ويَعُدّ observedCoins الماسات التي سجّلها RoomScope في جلسات LIVE لصانع المحتوى. ويظل اسم المستخدم الذي تغيّر قابلًا للاستدلال عليه عبر سجل الأسماء السابقة.
معاملات المسار
| Name | Type | Description |
|---|---|---|
uidRequired | string | اسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي. |
الطلب
curl "https://api.next.toktokdata.live/v1/creators/linh.live/insights" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "creator": { "uid": "6990000000000000001", "uniqueId": "linh.live" }, "aliases": [ { "uniqueId": "linh.live", "firstSeenAt": "2026-10-12T09:15:02.118Z", "lastSeenAt": "2026-11-01T14:02:41.530Z" }, { "uniqueId": "linh.official", "firstSeenAt": "2026-09-30T11:40:19.004Z", "lastSeenAt": "2026-10-12T08:55:47.912Z" } ], "daily": [ { "boardDay": "2026-10-31", "countryCode": "VN", "tiktokScore": 184250, "observedCoins": 171932, "liveScore": 184250, "liveExact": true, "leagueClass": "B2" }, { "boardDay": "2026-10-30", "countryCode": "VN", "tiktokScore": 97410, "observedCoins": null, "liveScore": 97410, "liveExact": false, "leagueClass": "B2" } ], "league": [ { "day": "2026-10-31", "leagueClass": "B2", "leagueRank": 14, "leagueCountry": "VN", "followers": 412880 } ], "roomOwner": { "roomId": "7432000000000000001", "ownerUid": "6990000000000000001", "ownerUniqueId": "linh.live", "claimantUid": null, "reason": "claim_confirmed", "checkedAt": "2026-11-01T14:00:03.221Z" } }, "provenance": { "observedAt": "2026-11-01T14:02:41.530Z", "freshness": "near_realtime", "source": "creator_analytics", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "creator-analytics-v1", "window": { "from": "2026-10-02T14:02:41.530Z", "to": "2026-11-01T14:02:41.530Z", "label": "30d" } }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب أفضل وقت لبدء البث المباشر
/v1/insights/best-timeالماسات وساعات الداعمين في جلسات LIVE المسجّلة لمنطقة ما خلال آخر windowDays يومًا، حسب يوم الأسبوع (0 = الاثنين) والساعة بتوقيت UTC. يُعاد حسابها يوميًا؛ وتكون cells فارغة ما دام لم يُسجَّل شيء للمنطقة.
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
regionOptional | string | رمز المنطقة وفق ISO 3166-1 alpha-2. Default: VN |
الطلب
curl "https://api.next.toktokdata.live/v1/insights/best-time" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "region": "VN", "windowDays": 28, "computedAt": "2026-11-01T01:00:04.870Z", "cells": [ { "weekday": 0, "hour": 12, "diamonds": 418230, "gifterHours": 1874 }, { "weekday": 0, "hour": 13, "diamonds": 652910, "gifterHours": 2410 }, { "weekday": 0, "hour": 14, "diamonds": 701455, "gifterHours": 2689 } ] }, "provenance": { "observedAt": "2026-11-01T01:00:04.870Z", "freshness": "near_realtime", "source": "creator_analytics", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "creator-analytics-v1", "window": { "from": "2026-10-04T01:00:04.870Z", "to": "2026-11-01T01:00:04.870Z", "label": "28d" } }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.
جلب حضور LIVE كل ساعة
/v1/insights/presenceلكل ساعة، عدد صنّاع المحتوى المصنّفين قيد التتبع في المنطقة الذين كانوا يبثون مباشرة، من الأقدم إلى الأحدث.
معاملات الاستعلام
| Name | Type | Description |
|---|---|---|
regionOptional | string | رمز المنطقة وفق ISO 3166-1 alpha-2. Default: VN |
hoursOptional | integer | عدد الساعات إلى الوراء. المدى 1–168. Default: 48 |
الطلب
curl "https://api.next.toktokdata.live/v1/insights/presence" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"الاستجابة
{ "data": { "region": "VN", "hours": 48, "points": [ { "hourStart": "2026-11-01T12:00:00.000Z", "liveCreators": 214, "trackedCreators": 1630 }, { "hourStart": "2026-11-01T13:00:00.000Z", "liveCreators": 251, "trackedCreators": 1642 }, { "hourStart": "2026-11-01T14:00:00.000Z", "liveCreators": 268, "trackedCreators": 1655 } ] }, "provenance": { "observedAt": "2026-11-01T14:05:01.402Z", "freshness": "near_realtime", "source": "creator_analytics", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "creator-analytics-v1", "window": { "from": "2026-10-30T14:05:01.402Z", "to": "2026-11-01T14:05:01.402Z", "label": "48h" } }}الأخطاء
400معامل أو جسم طلب غير صالح؛ ويحددcodeالمشكلة.401مفتاح API مفقود أو غير معروف.402لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضحresetAtموعد إعادة ضبط الرصيد.403المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.429تم تجاوز معدل الطلبات (في الثانية أو الدقيقة أو اليوم)؛ التزم بقيمةRetry-After.