商家探索

您可以使用含有 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/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"
}

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

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

例如，以下是取得 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"
}