Instagram 用户商家发现

让您可以获取关于其他 Instagram 商家或创作者 Instagram 用户的数据。

创建

不支持此操作。

读取

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

返回关于其他 Instagram 商家或创作者 Instagram 用户的数据。对发出查询的 Instagram 商家或创作者 Instagram 用户执行此请求，并使用 username 参数识别目标商家。

限制

该请求将不会返回有年龄限制的 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"
}

更新

不支持此操作。

删除

不支持此操作。