商家探索

您可以使用具有「Facebook 登入」的 Instagram API 取得關於其他 Instagram 專業帳號的基本中繼資料和衡量指標。

限制

不會傳回關於年齡限制 Instagram 專業帳號的資料。

端點

API 包含以下端點。請參閱端點的參考文件，瞭解參數和權限的相關需求。

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

範例

取得追蹤者和影音素材計數

此查詢範例顯示如何取得 Blue Bottle Coffee Instagram 專業帳號的追蹤者人數和已發佈的影音素材物件數量。請注意，商家探索查詢作業是依應用程式用戶的 Instagram 專業帳號編號（本案例中為 17841405309211844），搭配應用程式用戶嘗試取得其相關資料的 Instagram 專業帳號用戶名稱（本範例中為 bluebottle）執行。

要求範例

採用方便閱讀的格式。

curl -i -X GET \
 "https://graph.facebook.com/v25.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/v25.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"
}

取得影音素材的基本衡量指標

您可同時使用巢狀化的要求和欄位擴充來取得商業或創作者帳號的影音素材物件的公開欄位。請注意，這並未授予您直接存取影音素材物件的權限，對任何傳回的 IG 影音素材執行 GET 將會因為權限不足而失敗。

例如，針對 Blue Bottle Coffee 發佈的每個影音素材物件，取得留言和按讚次數的方式如下：

要求範例

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count,view_count}}

回覆範例

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "view_count": 7757,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}