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 处理已连接账户自己的帖子、评论、提及和数据洞察,并可将评论和提及在到达时转发到您的端点。
一个企业或创作者账户在滚动 7 天内可查询的不重复话题标签数量。
recent_media 只返回查询前 24 小时内发布的媒体。
top_media 每页返回的结果数最多,且仅能通过 after 游标翻页。
在 Meta 对三种设置的对比中,Instagram API 搭配 Instagram Login 不支持话题标签搜索。
话题标签 ID 是静态且全局的:同一话题标签在每个应用和用户下的 ID 保持不变。
话题标签搜索如何工作?
分两步完成,代表 Instagram 企业或创作者账户进行,其 ID 放在 user_id 中。将 q 设为话题标签名称并调用 GET /ig_hashtag_search,返回其 ID;Meta 称该 ID 是静态且全局的,因此可以存储。随后带上 user_id 与 fields 调用 GET /<HASHTAG_ID>/top_media 或 /recent_media,即可列出帖子。
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_counttop_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 标明该设置下不支持话题标签搜索。
每个连接每月 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 监控
验证时间