جمع بيانات Instagram: المنشورات والمقاطع القصيرة والتعليقات

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

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

ثلاثة عوائق تقف في الطريق:

• الواجهة الرسمية تغطي حساباتك أنت فقط. صُممت واجهات Instagram من Meta للحسابات الاحترافية التي تديرها. تمنحك Business Discovery حقولًا أساسية عن حسابات الأعمال وصنّاع المحتوى الأخرى، لكنها لا تتيح لمنتجك قراءة أي ملف شخصي عام أو سلاسل التعليقات أو منشورات الوسوم.
• التصفح دون تسجيل دخول مقيّد بشدة. يعرض Instagram شاشة تسجيل الدخول بعد بضع صفحات، ويفرض حدودًا صارمة على الزيارات المجهولة، وتتغير نقاط النهاية الداخلية التي يستخدمها تطبيق الويب دون إشعار.
• البيانات متفرقة. لكلٍّ من المقطع القصير والمنشور متعدد الصور والصورة المفردة بنية مختلفة، وتتوزع الأعداد والتعليقات النصية والصوت في أماكن مختلفة بحسب نقطة النهاية التي أعادتها.

إليك مقارنة بين الخيارات المعتادة:

يتبع باقي هذا الدليل الطريقة الأخيرة.

ما بيانات Instagram التي يمكنك الحصول عليها؟

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

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

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

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

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

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

{
  "data": {
    "platform": "instagram",
    "handle": "natgeo",
    "display_name": "National Geographic",
    "verified": true,
    "followers": 1234567,
    "following": 123,
    "posts_count": 12345,
    "bio": "…",
    "links": ["…"]
  },
  "meta": { "credits_used": 1, "credits_remaining": 99, "cache": "MISS", "data_age_s": 0 }
}

يكلّف الملف الشخصي رصيد واحد. الأعداد أرقام دائمًا، والحقل الذي لا يكشفه Instagram يعود بالقيمة null بدل أن يختفي، فلا تحتاج شيفرتك إلى معالجة خاصة لكل حساب.

احصل على منشورات حساب على Instagram

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

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

كل عنصر كائن Post يحتوي على text (التعليق النصي للمنشور)، وcreated_at، وmedia (عنصر لكل صورة أو فيديو، فيه type وurl وthumbnail_url وduration_s)، وengagement (likes وcomments وviews وغيرها)، وhashtags، وmentions، وis_ad. أما المنشورات متعددة الصور فتحتوي ببساطة على أكثر من عنصر في media.

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

import os, requests

posts, cursor = [], None
while True:
    params = {"handle": "natgeo", **({"cursor": cursor} if cursor else {})}
    res = requests.get(
        "https://api.crawlfeed.dev/v1/instagram/posts",
        params=params,
        headers={"Authorization": f"Bearer {os.environ['CRAWLFEED_KEY']}"},
    )
    body = res.json()
    posts.extend(body["data"])
    cursor = body["meta"].get("next_cursor")
    if not cursor or len(posts) >= 100:
        break

وإذا كنت تعرف مُعرّف المنشور مسبقًا، فإن /v1/instagram/post?id=… تعيد ذلك المنشور وحده.

احصل على التعليقات والردود على منشور

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

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

يحتوي كل Comment على text، وauthor، وlikes، وcreated_at، وreply_to_id. تتنقل التعليقات بين الصفحات بالطريقة نفسها التي تتنقل بها المنشورات. وللردود تحت تعليق واحد، استدعِ /v1/instagram/replies مع post_id وcomment_id معًا.

المقاطع القصيرة والقصص المميزة والإشارات والصوت

إلى جانب الشبكة الرئيسية، لدى Instagram أقسام خاصة به، ولكلٍّ منها طلبه:

• المقاطع القصيرة (Reels): تعرض /v1/instagram/reels?handle=… المقاطع القصيرة للحساب وحدها، وهذا عادةً ما تحتاجه لتحليلات الفيديو.
• القصص المميزة: تعرض /v1/instagram/collections?handle=… القصص المميزة للحساب، وتعيد /v1/instagram/collection/posts?id=… العناصر داخل إحداها.
• المنشورات المُشار فيها: تعيد /v1/instagram/tagged?handle=… المنشورات العامة التي أشارت فيها حسابات أخرى إلى ملف شخصي، وهي مفيدة لتتبّع الإشارات إلى العلامة التجارية والمحتوى الذي ينشئه المستخدمون.
• الصوت: تعرض /v1/instagram/track/posts?id=… المقاطع القصيرة التي تستخدم مقطعًا صوتيًا معيّنًا.

curl -G https://api.crawlfeed.dev/v1/instagram/reels \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=natgeo"

البحث والوسوم والمحتوى الرائج

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

• البحث بالكلمات المفتاحية: /v1/instagram/search/posts?q=… للمنشورات، و/v1/instagram/search/profiles?q=… للحسابات، و/v1/instagram/search?q=… للبحث العام في المنصة.
• الوسوم: تعيد /v1/instagram/hashtag?tag=… المنشورات التي تستخدم وسمًا. مرّر الوسم دون #.
• الرائج: تعيد /v1/instagram/trending ما هو رائج الآن، مع مُعامل country اختياري.

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

كيف تجمع بيانات صفحة Explore في Instagram؟

من يريد جمع بيانات صفحة Explore في Instagram يريد غالبًا أن يعرف ما الرائج الآن، عمومًا أو حول موضوع معيّن. لكن لا يمكن قراءة Explore نفسها مباشرة: فهي مخصّصة لكل حساب مسجّل الدخول، فلا يرى شخصان الصفحة نفسها أبدًا، ولا توجد منها نسخة عامة تُعرض دون تسجيل الدخول.

أما ما يمكنك قراءته فهو الإشارات العامة التي تُبنى منها Explore:

• المقاطع القصيرة الرائجة: تعيد /v1/instagram/trending المقاطع القصيرة الرائجة الآن، مع مُعامل country اختياري. وهي الأقرب إلى تبويب المقاطع القصيرة في Explore.
• المواضيع: تعيد /v1/instagram/topic?q=… المنشورات التي يختارها Instagram لموضوع ما، مثل basketball، مرتّبة من الأكثر رواجًا. وهي تقابل أزرار المواضيع أعلى صفحة Explore.
• الوسوم: /v1/instagram/hashtag?tag=…، كما سبق، لموضوع أضيق.

curl -G https://api.crawlfeed.dev/v1/instagram/topic \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=basketball"

شغّل هذه الطلبات وفق جدول زمني، فتحصل على موجز Explore واحد للجميع، وهذا ما تحتاجه للأبحاث وتتبّع الاتجاهات.

احصل على النص المفرّغ لمقطع قصير

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

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

يكلّف النص المفرّغ رصيد واحد، ويتضمن التوقيتات حين تتوفر.

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

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

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

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

إن كان جمهورك يكتب بالعربية، فأضف enrich=arabic إلى طلب الملف الشخصي أو المنشور أو التعليقات. يحصل كل عنصر على حقل enrichment فيه اللهجة والمشاعر والكيانات والموضوعات، مقابل 3 أرصدة إضافية لكل طلب. وتظهر فائدته الكبرى في سلاسل التعليقات، إذ يحوّل آلاف الردود إلى توزيع واضح للمشاعر.

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

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

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

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

الخلاصة

لجمع بيانات Instagram العامة، تعفيك واجهة API لجمع البيانات من تسجيل الدخول والخوادم الوسيطة والمحللات التي تتعطل كلما تغيّر تطبيق الويب. مع crawlfeed، يكلّف كل طلب على Instagram رصيدًا واحدًا، والشيفرة نفسها تعمل مع TikTok وYouTube وX وLinkedIn. المرجع الكامل في /docs/platforms/instagram.