话题标签搜索

查找标有特定话题标签的公开 Instagram 素材。

限制

• 您可以代表 Instagram 业务帐户或创作者帐户在 7 天内滚动查询最多 30 个独立的话题标签。查询话题标签后，系统将在 7 天内根据该限制进行计数。在此时间范围内，对同一话题标签进行的后续查询将不计入该限制范围，并且不会重置其 7 天初始查询计时器。
• 您无法对通过 API 发现的带有话题标签的素材对象进行评论。
• 不支持在快拍上使用话题标签。
• 不支持在话题标签查询中使用表情。
• 倘若请求中包含我们认定为敏感或具冒犯性的话题标签，API 将返回一般性错误。

要求

要使用此 API，您必须经过应用审核并请求批准以下事项：

• Instagram Public Content Access 功能
• instagram_basic 权限

端点

话题标签搜索 API 由以下节点和连线组成：

• GET /ig_hashtag_search — 获取特定话题标签的节点编号
• GET /{ig-hashtag-id} — 获取有关话题标签的数据
• GET /{ig-hashtag-id}/top_media — 获取具有特定话题标签的最热门照片和视频
• GET /{ig-hashtag-id}/recent_media — 获取具有特定话题标签的最近发布的照片和视频
• GET /{ig-user-id}/recently_searched_hashtags — 确定 Instagram 业务帐户或创作者帐户在本周搜索过的独立话题标签

如需了解受支持的字段、参数和使用要求，请参阅各个端点的参考文档。

常见用途

获取标有话题标签的素材

如需获取具有特定话题标签的所有照片和视频，请先使用 /ig_hashtag_search 端点，并加入此话题标签和进行查询的 Instagram 业务帐户或创作者帐户的编号。例如，如果代表编号为 17841405309211844 的 Instagram 业务帐户进行查询，则可以通过执行以下查询来获取“#coke”话题标签的编号：

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

此操作将返回“#Coke”话题标签节点的编号：

{
  "id" : "17873440459141021"
}

现在您已经拥有话题标签编号 (17873440459141021)，您可以查询其 /top_media 或 /recent_media 连线，并加入业务帐户编号，以获取具有“#coke”话题标签的素材对象集合。例如：

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

此操作将返回如下响应：

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}