话题标签搜索

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

限制

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

要求

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

端点

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

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

常见用途

获取标有话题标签的素材

如需获取具有特定话题标签的所有照片和视频,请先使用 /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"     
    }
  ]
}