商家发现

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

获取媒体的基本指标

您可以同时使用嵌套请求和字段扩展来获取业务帐户或创作者帐户媒体对象的公开字段。请注意，此操作不会授予您直接访问媒体对象的权限；由于权限不足，对返回的任何 Instagram 媒体执行 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"
}