商家探索

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

獲取媒體的基本衡量數據

您可以使用巢狀要求和欄位擴充來獲取商業帳戶或創作者帳戶的媒體物件公開欄位。請注意，此操作不會授權您直接存取媒體物件；由於權限不足，向系統傳回的任何 Instagram 媒體執行 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"
}