登录开始免费试用
easyCoexistence 官方 API

Instagram 话题标签搜索 API:按话题标签查找帖子

Instagram 话题标签搜索通过两次调用,查找带有某个话题标签的公开照片和视频。使用 user_id 与 q 调用 GET /ig_hashtag_search,可返回该话题标签的 ID;再调用 GET /<HASHTAG_ID>/top_media 列出热门帖子,或调用 /recent_media 列出过去 24 小时内发布的帖子。账户可在滚动 7 天内查询 30 个不重复的话题标签,需使用 Facebook Login 或 Unified Login。

easyCoexistence 使用 Instagram Login 连接 Instagram,让 Claude、ChatGPT 或您自己的代码能通过 Meta 官方 API 处理已连接账户自己的帖子、评论、提及和数据洞察,并可将评论和提及在到达时转发到您的端点。

30

一个企业或创作者账户在滚动 7 天内可查询的不重复话题标签数量。

24 hours

recent_media 只返回查询前 24 小时内发布的媒体。

50

top_media 每页返回的结果数最多,且仅能通过 after 游标翻页。

Not supported

在 Meta 对三种设置的对比中,Instagram API 搭配 Instagram Login 不支持话题标签搜索。

Static

话题标签 ID 是静态且全局的:同一话题标签在每个应用和用户下的 ID 保持不变。

话题标签搜索如何工作?

分两步完成,代表 Instagram 企业或创作者账户进行,其 ID 放在 user_id 中。将 q 设为话题标签名称并调用 GET /ig_hashtag_search,返回其 ID;Meta 称该 ID 是静态且全局的,因此可以存储。随后带上 user_id 与 fields 调用 GET /<HASHTAG_ID>/top_media 或 /recent_media,即可列出帖子。

Finding a hashtag's ID, then its recent posts
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee

{ "data": [ { "id": "<HASHTAG_ID>" } ] }

GET /<HASHTAG_ID>/recent_media
  ?user_id=<IG_ID>
  &fields=id,media_type,permalink,timestamp,like_count,comments_count

top_media 与 recent_media 有何区别?

top_media 返回带有该话题标签的最热门照片和视频,Meta 依据观看量与观众互动的综合情况判断热门程度。recent_media 返回最新发布的内容,仅限查询前 24 小时内发布的媒体,Meta 指出其返回结果不一定按时间顺序排列。两者都只返回公开媒体,不包括推广、加热和广告媒体,并以每页 50 条、使用 after 游标翻页。

会返回哪些字段?

以下为 Meta 参考文档中两个端点都列出的媒体字段,且两者都只返回公开的照片和视频:

  • id、media_type(CAROUSEL_ALBUM、IMAGE 或 VIDEO)、permalink 和 timestamp。
  • caption 和 comments_count,以及 like_count(除非所有者隐藏了点赞数)。
  • 相册媒体返回 children,其他媒体返回 media_url,但带有受版权保护或授权音频的视频除外。
  • 不包括 username:Meta 不允许在话题标签搜索返回的媒体上使用它。

有哪些限制?

Meta 按账户和话题标签设定限制:

  • 滚动 7 天内最多 30 个不重复话题标签。计数从首次查询开始;在此期间再次查询同一话题标签不计数,也不会重新计算其 7 天。
  • 即使已存储 ID,调用 top_media 或 recent_media 仍计为对该话题标签的一次查询。
  • GET /<IG_ID>/recently_searched_hashtags 列出该账户本周内搜索过的不重复话题标签。
  • 不支持限时动态中的话题标签及查询中的表情符号;Meta 认为敏感或冒犯性的话题标签会返回通用错误。
  • 通过此方式找到的媒体无法通过 API 添加评论。

话题标签搜索需要什么?

需要通过 Instagram Public Content Access 功能和 instagram_basic 权限的 App Review 审核,这是应用使用该功能前 Meta 的要求;还需要用户访问令牌,即可在关联 Page 上执行任务的人员通过 Facebook Login 获取的令牌,或 Unified Login 令牌。Meta 的概述列出 Instagram Login 不支持话题标签搜索,其调用受 Meta 平台速率限制约束,而非 Instagram 按账户的调用额度。Meta 列出的允许用途包括:查找话题标签营销活动中的内容、了解公众对品牌的情绪,以及识别活动参与者。

能否通过 easyCoexistence 搜索话题标签?

easyCoexistence 使用 Instagram Login 连接 Instagram,可访问已连接账户自己的帖子、评论、提及和数据洞察。Meta 仅在 Facebook Login 和 Unified Login 下提供话题标签搜索,因此它不在此连接的范围内。连接所涵盖的内容为:通过 list_social_posts 获取账户自己的帖子,以及将评论和提及在到达时转发到您的端点。

常见错误

  • 将每周配额用于测试。每个新话题标签都计入 7 天内的 30 个额度,即使已存储 ID,获取其媒体也会计数。
  • 在话题标签结果中请求 username。Meta 不会为通过话题标签搜索找到的媒体返回该字段。
  • 把 recent_media 当作存档。它只涵盖查询前 24 小时内发布的媒体,且并非严格按时间顺序排列。
  • 使用 Instagram Login 令牌调用。Meta 标明该设置下不支持话题标签搜索。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,随连接增加而降至 US$ 0.75,前 3 天免费。

常见问题

Instagram API 在没有 App Review 的情况下能搜索话题标签吗?

不能。Meta 要求应用先通过 Instagram Public Content Access 功能和 instagram_basic 的 App Review 审核,才能调用话题标签搜索。

我能看到用某个话题标签发帖的人是谁吗?

无法通过 username 查看,Meta 不会在话题标签结果中提供该字段。每条帖子的 permalink 可在 Instagram 上打开该帖。

话题标签搜索包括限时动态吗?

不包括。Meta 不支持限时动态中的话题标签,两个端点都只返回公开的照片和视频。

重复查询同一话题标签会计两次吗?

不会。7 天内的重复查询不计入 30 个额度,也不会重新开始该话题标签的计时。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间