商家探索

您可以使用 Facebook 登入 Instagram API，獲取其他 Instagram 專業帳戶的基本中繼資料及衡量數據。

限制

如果 Instagram 專業帳戶設有年齡限制，則系統不會傳回其相關資料。

端點

此 API 由以下端點組成。如需有關參數和權限要求的資訊，請參閱此端點的參考文件。

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

範例

獲取追蹤者人數和影音內容數量

此查詢範例示範如何獲取 Blue Bottle Coffee Instagram 專業帳戶的追蹤者人數，以及其已發佈的影音內容物件數量。請注意，商家探索查詢會使用您應用程式用戶所嘗試獲取相關資料之 Instagram 專業帳戶的用戶名稱（此範例中為 bluebottle），並在應用程式用戶的 Instagram 專業帳戶編號（此範例中為 17841405309211844）上執行。

要求範例

已設定格式以便閱讀。

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"
}

獲取媒體的基本衡量數據

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