استكشاف الأنشطة التجارية

يمكنك استخدام Instagram API مع تسجيل دخول فيسبوك للحصول على بيانات التعريف وأدوات القياس الأساسية حول الحسابات الاحترافية الأخرى في Instagram.

التقييدات

لن يتم إرجاع البيانات المتعلقة بالحسابات الاحترافية في Instagram المُقيدة بفئة عمرية معينة.

نقاط النهاية

تتكون API من نقاط النهاية التالية. يمكنك الرجوع إلى الوثائق المرجعية لنقاط النهاية للحصول على المعلمات ومتطلبات الأذونات.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

أمثلة

الحصول على عدد المتابعين والوسائط

توضح عينة الاستعلام هذه كيفية الحصول على عدد المتابعين وعدد كائنات الوسائط التي تم نشرها في الحساب الاحترافي على Instagram الخاص بـ Blue Bottle Coffee. لاحظ أنه يتم تنفيذ استعلامات اكتشاف الأنشطة التجارية على معرف الحساب الاحترافي في Instagram (في هذه الحالة، يكون 17841405309211844) مع اسم مستخدم الحساب الاحترافي على Instagram الذي يحاول مستخدم التطبيق الحصول على معلومات حوله (وهو bluebottle في هذا المثال).

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

عينة من الاستجابة

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

الحصول على الوسائط

نظرًا إلى أنه يمكنك إجراء طلبات متداخلة عن طريق تحديد عنصر ربط عبر المعلمة fields، فيمكنك طلب عنصر الربط media التابع للحساب الاحترافي المستهدف للحصول على جميع كائنات الوسائط المنشورة لديه.

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

عينة من الاستجابة

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

الحصول على أدوات القياس الأساسية حول الوسائط

يمكنك استخدام الطلبات المتداخلة وتوسيع الحقل للحصول على الحقول العامة لكائنات الوسائط في حساب الأعمال أو حساب منشئ المحتوى. لاحظ أن ذلك لا يمنحك الإذن للوصول إلى كائنات الوسائط مباشرةً، وسيفشل إجراء طلب GET على أي وسائط IG تم إرجاعها نظرًا لعدم توفير أذونات كافية.

على سبيل المثال، فيما يلي كيفية الحصول على عدد التعليقات وتسجيلات الإعجاب لكل كائن من كائنات الوسائط التي تم نشرها بواسطة Blue Bottle Coffee:

عينة من الطلب

تم التنسيق لإمكانية القراءة.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

عينة من الاستجابة

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}