جمع بيانات TikTok: الفيديوهات والتعليقات

يستحوذ TikTok على جزء كبير من انتباه مستخدمي الإنترنت في 2026، وهو أيضًا من أصعب المنصات في استخراج البيانات منها. يشرح هذا الدليل كيف تجمع بيانات TikTok العامة (الملفات الشخصية، والفيديوهات، والتعليقات، والوسوم، والأصوات، والنصوص المفرّغة) بطلبات HTTPS عادية، مع شيفرة جاهزة للتشغيل بلغات cURL وJavaScript وPython.

لماذا يصعب الحصول على بيانات TikTok؟

ثلاثة أمور تجعل TikTok مختلفًا عن أي موقع عادي:

• لا توجد واجهة API عامة للبيانات. واجهات TikTok الرسمية إما للأبحاث الأكاديمية المعتمدة، وإما للبيانات التي يمنحها المستخدم لتطبيقك من حسابه هو. ولا توجد نقطة نهاية تعيد الفيديوهات العامة لأي صانع محتوى لصالح منتج تجاري.
• تطبيق الويب مبني لصدّ أدوات جمع البيانات. تُعرض الصفحات من جهة المتصفح، وتتغير توقيعات الطلبات، وتخضع عناوين IP الخاصة بمراكز البيانات للتحقق. وأداة الجمع التي تعمل اليوم كثيرًا ما تتعطل الأسبوع القادم.
• بنية البيانات مربكة. تعود الأعداد نصوصًا في موضع وأرقامًا في موضع آخر، وتتداخل بيانات الفيديو والكاتب والموسيقى بطريقة مختلفة في كل نقطة نهاية.

يمكنك أن تدير أسطولًا من المتصفحات الخفية مع خوادم وسيطة سكنية، أو أن تستدعي واجهة API تتولى ذلك عنك. يتبع باقي هذا الدليل الطريقة الثانية.

ما الذي يمكنك الحصول عليه من TikTok

كل الطلبات أدناه متاحة على crawlfeed اليوم. يُولَّد الجدول من فهرس الواجهة نفسه، لذا فنقاط النهاية والأسعار هي بالضبط ما ستدفعه:

تعود كل البيانات بالأنواع الموحّدة في crawlfeed (Profile وPost وComment وغيرها)، وهي نفسها على كل المنصات الـ26.

احصل على ملف شخصي من TikTok

ابدأ بملف شخصي. تحتاج إلى مفتاح API (تحصل الحسابات الجديدة على 100 رصيد مجاني) واسم المستخدم دون @:

curl -G https://api.crawlfeed.dev/v1/tiktok/profile \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

الاستجابة كائن Profile داخل الغلاف المعتاد. بعد الاختصار، ومع أرقام توضيحية، تبدو هكذا:

{
  "data": {
    "platform": "tiktok",
    "handle": "charlidamelio",
    "display_name": "charli d’amelio",
    "verified": true,
    "followers": 155000000,
    "following": 1300,
    "posts_count": 2800,
    "bio": "…",
    "links": ["…"]
  },
  "meta": { "credits_used": 1, "credits_remaining": 99, "cache": "MISS", "data_age_s": 0 }
}

يكلّف الملف الشخصي رصيد واحد. الأعداد أرقام لا نصوص، والحقل الذي لا يكشفه TikTok يعود بالقيمة null بدل أن يختفي.

احصل على فيديوهات صانع محتوى

تعيد /v1/tiktok/posts أحدث فيديوهات صانع المحتوى، من الأحدث إلى الأقدم، صفحةً في كل طلب:

curl -G https://api.crawlfeed.dev/v1/tiktok/posts \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

كل عنصر كائن Post يحتوي على text، وcreated_at، وmedia (رابط الفيديو وصورته المصغّرة ومدته)، وengagement (likes وcomments وshares وviews وsaves)، وhashtags، وmentions، وis_ad.

للانتقال إلى الصفحة التالية، مرّر قيمة meta.next_cursor في المُعامل cursor. وإذا غاب next_cursor فقد وصلت إلى النهاية. تُحتسب كل صفحة، فتوقف فور حصولك على ما تحتاجه:

let cursor;
const videos = [];
do {
  const params = new URLSearchParams({ handle: 'charlidamelio', ...(cursor ? { cursor } : {}) });
  const res = await fetch(`https://api.crawlfeed.dev/v1/tiktok/posts?${params}`, {
    headers: { Authorization: `Bearer ${process.env.CRAWLFEED_KEY}` },
  });
  const { data, meta } = await res.json();
  videos.push(...data);
  cursor = meta.next_cursor;
} while (cursor && videos.length < 100);

احصل على التعليقات على فيديو

مرّر مُعرّف الفيديو في post_id:

curl -G https://api.crawlfeed.dev/v1/tiktok/comments \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "post_id=<post_id>"

يحتوي كل Comment على text، وauthor، وlikes، وcreated_at، وreply_to_id. وللردود تحت تعليق واحد، استخدم /v1/tiktok/replies مع post_id وcomment_id.

البحث والوسوم والأصوات

ثلاث طرق لاكتشاف المحتوى بدل قراءة حساب تعرفه:

• البحث بالكلمات المفتاحية: /v1/tiktok/search/posts?q=… للفيديوهات، و/v1/tiktok/search/profiles?q=… لصنّاع المحتوى.
• الوسوم: تعيد /v1/tiktok/hashtag?tag=… الفيديوهات التي تستخدم وسمًا.
• الأصوات: تصف /v1/tiktok/track?id=… مقطعًا صوتيًا، وتعرض /v1/tiktok/track/posts?id=… الفيديوهات التي تستخدمه.

curl -G https://api.crawlfeed.dev/v1/tiktok/hashtag \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "tag=coffee"

احصل على النص المفرّغ لفيديو على TikTok

للأبحاث والملخصات، أو لتمرير الفيديوهات إلى نموذج لغوي كبير، فالنص المفرّغ هو عادةً ما تحتاجه:

curl -G https://api.crawlfeed.dev/v1/tiktok/transcript \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "id=<id>"

يكلّف النص المفرّغ 10 أرصدة لأن إنتاجه في المصدر أعلى تكلفة. وحين تتوفر التوقيتات، يحمل كل مقطع وقت بدايته ونهايته.

تعامل مع الأخطاء وحدّ الطلبات

الأخطاء بصيغة problem details وفق RFC 9457 مع code ثابت، فاعتمد على الرمز لا على نص الرسالة:

يُستردّ رصيد الطلب الفاشل تلقائيًا، فلن تدفع مرتين عند إعادة المحاولة أبدًا.

أضف تحليل المشاعر واللهجة العربية

إن كان جمهورك يكتب بالعربية، فأضف enrich=arabic إلى طلب الملف الشخصي أو الفيديو أو التعليقات. يحصل كل عنصر على حقل enrichment فيه اللهجة (خليجية، أو مصرية، أو شامية، أو مغاربية، أو فصحى)، والمشاعر، والكيانات، والموضوعات، مقابل 3 أرصدة إضافية لكل طلب.

استخدم بيانات TikTok من Claude أو Cursor

إن كنت تفضّل السؤال على كتابة الشيفرة، فاربط خادم MCP من crawlfeed، وسيحصل مساعدك على الطلبات نفسها كأدوات:

claude mcp add --transport http crawlfeed https://mcp.crawlfeed.dev/mcp \
  --header "Authorization: Bearer $CRAWLFEED_KEY"

ثم اسأل مثلًا: «ماذا نشر حساب ‎@charlidamelio هذا الأسبوع، وأي فيديو حصد أكثر التعليقات؟». تجد طريقة الإعداد لكل عميل في دليلنا إلى MCP.

الخلاصة

لجمع بيانات TikTok العامة، تعفيك واجهة API لجمع البيانات من صيانة المتصفحات والخوادم الوسيطة والمحللات التي تتعطل كل بضعة أسابيع. مع crawlfeed، تكلّف معظم الطلبات رصيدًا واحدًا، والشيفرة نفسها تعمل مع Instagram وYouTube وX. المرجع الكامل في /docs/platforms/tiktok.