Instagram 用戶商家探索

讓您可以獲取關於其他 Instagram 商家或創作者 Instagram 用戶的數據。

建立

不支援這項操作。

讀取

GET /{ig-user-id}?fields=business_discovery.username({username})

傳回關於其他 Instagram 商家或創作者 Instagram 用戶的數據。為提出查詢的 Instagram 商家或創作者 Instagram 用戶執行此要求，並且使用 username 參數識別目標商家。

限制

系統將不會傳回設有年齡限制的 Instagram 商家 Instagram 用戶的資料。

查詢字串參數

{username}（必要項目）—Instagram 商家或創作者 Instagram 用戶之用戶名稱，而您要從中獲取其數據。

權限

含有下列權限的 Facebook 用戶存取憑證：

instagram_basic
instagram_manage_insights
pages_read_engagement 或 pages_show_list

如果憑證是來自在企業管理平台獲授予專頁角色的用戶，則同時必須持有以下其中一項權限：

ads_management
pages_read_engagement
business_management

欄位擴充

您可以使用欄位擴充獲取目標 Instagram 用戶的公開欄位。請參閱 Instagram 用戶參考資料，獲取公開欄位清單。

包含欄位擴充的要求範例

獲取關於 Instagram 商家 Instagram 用戶「Blue Bottle Coffee」的資料，並使用欄位擴充獲取其追蹤者和媒體數量。

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

回應範例

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

使用欄位擴充存取關係連線

您還可以使用欄位擴充存取目標 Instagram 用戶的 /media 關係連線，並指定要就每個 Instagram 媒體物件傳回的欄位和衡量數據。請參閱媒體節點參考資料，獲取公開欄位清單。

在 2021 年 9 月 7 日前，針對 10.0 版和更舊版本的調用：如果影音素材擁有者已隱藏相關內容的讚好次數，Instagram 影音素材的 like_count 欄位將傳回 0。

在 2021 年 9 月 7 日前，針對 11.0 及以上版本的調用和所有版本：如果透過另一個端點或欄位擴充間接查詢 Instagram 影音素材，而且影音素材擁有者已隱藏相關內容的讚好次數，API 回應將省略 like_count 欄位。若是直接查詢 Instagram （只能由 Instagram 影音素材擁有者提出），即使擁有者隱藏了影音素材的讚好次數，系統仍會傳回實際的讚好次數。

包含關係連線的要求範例

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

包含關係連線的回應範例

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

分頁

/media 關係連線支援游標型分頁，因此透過欄位擴充存取時，如果回應包含多頁數據，回應便將包含 before 和 after 游標。不過，有別於標準的游標型分頁，回應將不會包含 previous 或 next 欄位，因此您將需要使用 before 和 after 游標手動建立 previous 和 next 查詢字串，以便翻頁瀏覽傳回的資料組合。

要求範例

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

回應範例

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "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"
}

更新

不支援這項操作。

刪除

不支援這項操作。