商家探索

您可以使用 Instagram 圖形 API 取得關於其他 Instagram 商業和創作者帳號的基本中繼資料和衡量指標。

限制

不會傳回年齡限制 Instagram 商業帳號的資料。

端點

API 包含下列端點。請參閱端點的參考文件，瞭解可用的參數和權限要求。

• GET /{ig-user-id}/business_discovery

範例

取得帳號的追蹤者和影音素材計數

此查詢範例顯示如何取得 Blue Bottle Coffee Instagram 商業帳號的追蹤者人數和發佈過的影音素材物件數量。請注意，商家探索查詢是在 Instagram 商業或創作者帳號的編號上執行（在此案例中為 17841405309211844），而非您嘗試要取得資料的 Instagram 商業或創作者帳號的用戶名稱（本範例中為 bluebottle）。

要求範例

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

回應範例

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

取得影音素材

由於您可透過 fields 參數指定關係連線來建立巢狀化的要求，您可要求目標商業或創作者帳號的 media 關係連線取得所有已發佈的影音素材物件：

要求範例

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={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/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={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"
}