IG 用戶商家探索

讓您能取得與其他 Instagram 商業帳號或創作者 IG 用戶相關的資料。

建立

不支援執行此作業。

讀取

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

傳回與其他 Instagram 商業帳號或創作者 IG 用戶相關的資料。針對提出這項查詢的 Instagram 商業帳號或創作者 IG 用戶發出這項要求，再以 username 參數識別目標商家。

限制

不會傳回經過年齡審核之 Instagram 商業帳號 IG 用戶的資料。

查詢字串參數

{username}（必要）：您想取得其相關資料之 Instagram 商業帳號或創作者 IG 用戶的用戶名稱。

權限

具備下列權限的 Facebook 用戶存取權杖：

instagram_basic
instagram_manage_insights
pages_read_engagement 或 pages_show_list

如果此權杖的用戶是透過企業管理平台獲得粉絲專頁角色，也需有下列任一權限：

ads_management
pages_read_engagement
business_management

欄位擴充

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

使用欄位擴充功能之要求範例

取得關於 Instagram 商業帳號 IG 用戶「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"
}

存取含欄位擴充的關係連線

也可以用欄位擴充功能存取目標 IG 用戶的 /media 關係連線，並指定每個 IG 影音內容物件應傳回的欄位和衡量指標。如需公開欄位的清單，請參閱影音內容節點參考資料。

直到 2021 年 9 月 7 日的 10.0 及以上版本呼叫：IG 影音內容的 like_count 欄位若遇到下列情況會傳回 0：影音內容擁有者已隱藏按讚數。

11.0 以上版本呼叫和在 2021 年 9 月 7 日的所有版本：如果透過另一個端點或欄位擴充功能間接查詢 IG 影音內容，當影音內容擁有者已隱藏按讚數時，系統將會省略 API 回應中的 like_count 欄位。不過，即使已隱藏影音內容的按讚數，直接查詢 IG 影音內容（只能由 IG 影音內容擁有者執行）仍會傳回實際按讚數。

含關係連線的要求範例

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

更新

不支援執行此作業。

刪除

不支援執行此作業。