هل تستطيع واجهة برمجة التطبيقات (API) من TikTok البحث عن الفيديوهات والوسوم والاتجاهات؟
نعم، تستطيع واجهة TikTok API البحث في الفيديوهات والإعلانات والاتجاهات، لكن كل منها في واجهة منفصلة: تبحث Research API في الفيديوهات العامة بالكلمة المفتاحية أو الوسم أو اسم المستخدم أو المنطقة أو التاريخ، وذلك للباحثين الذين توافق عليهم TikTok. تبحث Commercial Content API في الإعلانات بالكلمة المفتاحية أو اسم المعلن. وتعيد API for Business الوسوم الشائعة وفيديوهاتها الرائجة وكلمات البحث الرائجة. وتقرأ Display API الملف الشخصي للمستخدم المصرّح له وفيديوهاته العامة.
يربط easyCoexistence حسابات TikTok عبر API for Business، فيتمكن Claude أو ChatGPT أو منصتك الخاصة من عرض منشورات الحساب وتعليقاته، وقراءة تحليلاته، ويمنح get_social_credentials كودك الخاص token لمسارات business/ مثل اقتراحات الوسوم، مع مراقبة كل اتصال على مدار الساعة.
عدد الطلبات المسموح بها يوميًا في Research API، بحد أقصى 100,000 سجل، ويُعاد ضبط الحصة عند منتصف الليل بالتوقيت العالمي المنسّق (UTC).
أقصى مدة بين start_date وend_date في استعلام فيديو واحد لـ Research API، ويعيد حتى 100 فيديو في كل طلب.
/discovery/trending_list/ يرتّب الوسوم الشائعة لبلد وفئة محددين خلال آخر 1 أو 7 أو 30 أو 120 يومًا.
/discovery/trending/search/ يعيد كلمات البحث الرائجة، وهو متاح للحسابات التي تملك Advanced Access أو حساب Verified Business Account المعتمد.
أقصى طول لقيمة search_term في Commercial Content API، وتُطابق كعبارة دقيقة افتراضيًا أو كعبارة تقريبية.
أي واجهة TikTok تستطيع البحث؟
عدة واجهات على بوابتين للمطورين، كل منها موجه لنوع مختلف منهم. تستضيف developers.tiktok.com كلًا من Research API وCommercial Content API وDisplay API، بينما تستضيف business-api.tiktok.com واجهة API for Business، التي تغطي نقاط النهاية (endpoints) الخاصة بها Discovery وAccounts وMentions، وهي الاتجاهات ومحتوى الحساب التجاري نفسه:
كيف تبحث Research API عن الفيديوهات؟
عبر POST https://open.tiktokapis.com/v2/research/video/query/ مع رمز الوصول (token) للعميل الذي يحمل النطاق research.data.basic. يجمع كائن query الشروط باستخدام and أو or أو not، ولكل شرط عملية مثل EQ أو IN على حقل مثل keyword أو hashtag_name أو username أو region_code أو create_date أو video_length. ولا يزيد الفاصل بين start_date وend_date، المكتوبتين بصيغة YYYYMMDD، على 30 يومًا، ويعيد max_count حتى 100 فيديو في الطلب:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'ماذا تعيد Research API، وما مدى حداثتها؟
حقول الفيديو العامة المذكورة في fields، مثل id و video_description و create_time و region_code و view_count و like_count و comment_count و share_count و hashtag_names و username. تحذّر الأسئلة الشائعة لدى TikTok من أن إحصاءات مثل عدد المشاهدات والمتابعين قد تحتاج حتى 10 أيام لتتحدّث، وأن الفيديوهات الجديدة قد تحتاج حتى 48 ساعة لتظهر في البحث. الحصة اليومية 1,000 طلب، وحتى 100,000 سجل عبر واجهات البحث، وتُعاد عند منتصف الليل بالتوقيت العالمي المنسّق (UTC).
من يمكنه استخدام Research API؟
الباحثون الذين توافق TikTok على مشروعهم؛ حساب المطور وحده لا يمنح الوصول. تدرج TikTok المؤسسات الأكاديمية في الولايات المتحدة ودول EEA وبريطانيا وكندا وسويسرا، والهيئات البحثية غير الربحية أو المستقلة في الاتحاد الأوروبي، والمؤسسات الأكاديمية أو غير الربحية في البرازيل التي تدرس سلامة الشباب على الإنترنت. يجب أن يكون المتقدمون مستقلين عن المصالح التجارية، ولديهم مقترح بحثي محدد وتمويل معلن ومراجعة أخلاقية، وتجيب TikTok عادةً خلال 4 أسابيع. وعندما سُئلت عما إذا كان المنشئون والمعلنون والمستخدمون التجاريون مؤهلين، أجابت أسئلتها الشائعة بالنفي.
كيف تبحث عن الإعلانات بواجهة Commercial Content API؟
عبر POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ والنطاق research.adlib.basic. يأخذ search_term حتى 50 حرفًا، ويُطابق كعبارة دقيقة exact_phrase افتراضيًا أو كعبارة تقريبية fuzzy_phrase، وهي تجد أيًا من كلماتها أو كلها بأي ترتيب. وتضيّق المرشحات النتائج حسب تواريخ النشر والدول المستهدفة، وكل استدعاء يعيد 10 إعلانات كحد أقصى. تقول صفحة المنتج لدى TikTok إن البيانات تبدأ بإعلانات من الاتحاد الأوروبي، وتبقى متاحة حتى سنة بعد آخر ظهور للإعلان. ويمكن للجمهور والباحثين في أي دولة التقدّم عبر نموذج إلكتروني، وتتوقع TikTok الرد خلال يومي عمل.
ما الاتجاهات التي تعيدها API for Business؟
اتجاهات نقاط نهاية Discovery الخاصة بها، وتختلف بحسب الـ token الذي تأخذه. يرتّب /discovery/trending_list/ حتى 200 وسم شائع لبلد، الولايات المتحدة افتراضيًا، وفئة صناعية، خلال 1 أو 7 أو 30 أو 120 يومًا، مع ترتيب كل وسم وعدد مشاهداته ومنشوراته. ويعيد /discovery/video_list/ أعلى 20 فيديو رائجًا لما يصل إلى 10 من هذه الوسوم. يأخذ الاثنان advertiser_id وtoken الخاص بالمعلن. ويأخذ اثنان آخران token حساب TikTok مع النطاق discovery.search.words، وهما متاحان للحسابات التي تملك Advanced Access أو حساب Verified Business Account المعتمد:
- /discovery/trending/search/: 20 كلمة بحث رائجة على TikTok، أو كلمات مخصصة للحساب عبر
is_personalized، بحسب الإعداد. - /discovery/trending/search/keyword/: 20 كلمة بحث مقترحة لاستعلام يصل إلى 255 حرفًا، مثل منتج أو علامة تجارية.
ماذا يمكن لحساب TikTok نفسه أن يبحث عنه عبر واجهته؟
الوسوم الخاصة بتعليقاته، والمنشورات التي تحمل وسوم علامته التجارية. تأخذ GET /business/hashtag/suggestion/ كلمة مفتاحية ولغة اختيارية، وتعيد 10 وسوم مرتبة حسب المطابقة التامة ثم حسب عدد المنشورات، ولكل منها post_count. وتعيد نقطة نهاية Mentions /business/mention/hashtag/video/list/ حتى 1,000 منشور عام من آخر 90 يومًا يستخدم أحد وسوم العلامة التجارية التي فعّلتها الشركة، بحد أقصى 50 منها، مرتبةً حسب الوقت أو الإعجابات أو التعليقات أو المشاركات. ويحتاج ذلك إلى النطاق biz.brand.insights وحساب يملك صلاحية Advanced Access أو حساب Verified Business Account معتمد.
هل يمكن لـ Display API البحث؟
لا. تقرأ بيانات المستخدم الذي فوّض التطبيق: تعيد /v2/user/info/ ملف ذلك المستخدم الشخصي، وتعيد /v2/video/list/ فيديوهاته العامة، الأحدث أولًا وحتى 20 في الصفحة، أما /v2/video/query/ فيعيد فيديوهات بعينها بالمعرّف. وتحتاج الواجهات الثلاث إلى النطاقين user.info.basic وvideo.list. ولا تأخذ أيٌّ من نقاط نهايتها كلمة مفتاحية أو وسمًا.
ماذا يمكن لـ easyCoexistence أن يبحث عنه على TikTok؟
ما تُجيب به واجهة الحساب المتصل نفسه. تعرض list_social_posts أحدث منشورات الحساب، وlist_social_comments تعليقات منشور، بينما يستدعي الكود الخاص بك مسارات API for Business تحت business/ بـ token من get_social_credentials، بما فيها اقتراحات الوسوم. تأخذ مسارات /discovery/ token مُعلِن، فلا يصل إليها token الحساب، كما أن Research API وCommercial Content API منتجان منفصلان على developers.tiktok.com، ويتطلب كل منهما تقديم تطبيق خاص به.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>الأخطاء الشائعة
- التقدّم للحصول على Research API لتتبّع علامة تجارية. تنفي الأسئلة الشائعة لدى TikTok الوصول عن المنشئين والمعلنين والمستخدمين التجاريين، وتوافق على مشاريع البحث غير التجارية.
- الاستعلام عن فترة طويلة في استدعاء Research API واحد. لا يمكن أن يتجاوز end_date موعد start_date بأكثر من 30 يومًا، لذا قسّم الفترات الأطول إلى نوافذ زمنية.
- قراءة اقتراحات الوسوم على أنها اتجاهات. يرتّب /business/hashtag/suggestion/ حسب المطابقة التامة وعدد المنشورات، بينما يرتّب /discovery/trending_list/ الشعبية خلال فترة مختارة.
- استدعاء نقاط نهاية البحث الرائجة لحساب شخصي. تستجيب هذه النقاط للحسابات التي تملك Advanced Access أو حساب Verified Business Account المعتمد، ويجب أن يحمل token النطاق discovery.search.words، وهذا لا يتوفر للحساب الشخصي.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكنني البحث عن فيديوهات TikTok بالكلمة المفتاحية عبر الواجهة؟
نعم، عبر Research API بعد موافقة TikTok على مشروع بحثك: يقبل استعلام الفيديو شروط keyword و hashtag_name على الفيديوهات العامة، بحد أقصى 100 فيديو للطلب.
هل توجد واجهة TikTok للوسوم الرائجة؟
نعم. يرتّب /discovery/trending_list/ في API for Business حتى 200 وسم شائع لبلد وفئة محددين، ولكل وسم مشاهداته ومنشوراته، وذلك بواسطة token المعلن.
هل توجد واجهة TikTok للفيديوهات الرائجة؟
نعم. يعيد /discovery/video_list/ في API for Business أعلى 20 فيديو رائجًا لما يصل إلى 10 وسوم شائعة، ويحتاج إلى advertiser_id و token المعلن.
هل يمكن لواجهة TikTok العثور على التعليقات التي تذكر حسابي؟
نعم، للحسابات التي تملك Advanced Access أو حساب Verified Business Account المعتمد: تعمل Mentions API تحت النطاقين biz.brand.insights وcomment.list، فتعيد /business/mention/comment/list/ حتى 1,000 تعليق أو رد يشير إلى الحساب.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في