问答
怎么用 API 拿到某个 Instagram 话题标签下的帖子?
简短回答
调用 Instagram 话题帖子接口,传标签名(不带 #):每页约 10 条公开帖子,带文案、作者、点赞、评论数和发布时间,每次 $0.004。不需要商业账号,不用过 App Review,也没有每周标签数的限制;不过拿到的是这个标签下的一部分帖子,不是全部,也不按时间排。20 个标签各翻 5 页,共 $0.40。
一个户外露营装备品牌,每周想看看 #vanlife、#overlanding 和十几个小标签下大家在发什么,从里面挑值得买授权的图片,也找找能合作的博主。Instagram 官方的路子是 Graph API 里的 Hashtag Search:要有一个连到你 App 的 Instagram 商业账号或创作者账号,要为 Instagram Public Content Access 功能过 App Review,每个账号在任意连续 7 天里最多查 30 个不同的标签。recent_media 只返回最近 24 小时内的帖子,而且不能请求发帖账号的 username。很多人想要“某个标签下的全部帖子,连同是谁发的”,卡住的就是最后这一条。
Instagram 话题帖子把标签名作为 id 传入,每条帖子都带作者。
步骤
- 列标签。 大而泛的标签和买家常用的具体标签搭配着用。小标签往往比大标签更有用。
- 逐个标签翻页,用
cursor,每个标签翻几页就够。 - 合并排序。 一条帖子常常同时带着你列的好几个标签,先按
id去重,再按metrics.likes和metrics.comments排序。 - 重点帖子再细看。 Instagram 帖子详情($0.004)能补上 Reel 的播放量、多图帖子的每一张图,以及合拍帖的其他作者。如果是 Reel,Instagram 视频字幕能拿到里面说的话($0.004,视频最长两分钟)。
每周跑一次
import csv, os, requests
API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
TAGS = ["vanlife", "overlanding", "rooftoptent", "campervan"]
def tag_posts(tag, max_pages=5):
cursor = None
for _ in range(max_pages):
params = {"id": tag, **({"cursor": cursor} if cursor else {})}
body = requests.get(API + "/v1/instagram/hashtags/posts/list", headers=H, params=params, timeout=60).json()
if body["code"] != "ok":
raise RuntimeError(f"{body['code']}: {body['message']}")
yield from body["data"]["items"]
if not body["page"]["has_more"]:
return
cursor = body["page"]["next_cursor"]
posts = {}
for tag in TAGS:
for p in tag_posts(tag):
posts.setdefault(p["id"], {**p, "tags": set()})["tags"].add(tag)
score = lambda p: (p["metrics"]["likes"] or 0) + (p["metrics"]["comments"] or 0)
with open("hashtag-posts.csv", "w", newline="", encoding="utf-8") as f:
w = csv.writer(f)
w.writerow(["url", "author", "likes", "comments", "published_at", "tags", "caption"])
for p in sorted(posts.values(), key=score, reverse=True):
w.writerow([p["url"], p["author"]["username"], p["metrics"]["likes"], p["metrics"]["comments"],
p["published_at"], " ".join(sorted(p["tags"])), p["text"][:200]])
费用
| 任务 | 调用次数 | 费用 |
|---|---|---|
| 一个标签,翻 5 页 | 5 | $0.02 |
| 20 个标签,各翻 5 页 | 100 | $0.40 |
| 每周跑一次,跑一个月 | 400 | $1.60 |
| 最好的 50 条帖子查详情 | 50 | $0.20 |
列表调用即使这一页是空的也照常计费;调用出错的话,只要请求到了数据源,也一样计费。
局限
- 帖子按搜索引擎收录的顺序返回。拿到的是标签下的一部分帖子,不是全部历史,也没法要“最近 24 小时发的全部帖子”。
- 每个标签能翻的页数有限。想看到更多,与其往深处翻,不如多加几个相关标签。
- 偶尔某一页会缺作者名或互动数,
meta.unavailable会列出哪些字段是空的。需要的话,用帖子详情把这些帖子补齐。 - 拿不到快拍(Stories),也拿不到私密账号的帖子。
什么时候用 Graph API 更合适
如果你已经有一个过了审核的商业 App,要在几个小时内看到自家活动标签下的最新帖子,recent_media 每页最多返回 50 条最近 24 小时内的帖子,top_media 返回最热门的。每周 30 个标签,跑一个品牌活动足够了。要跨很多标签做调研,或者手里没有商业账号,这里的抽样方式更容易上手。更多做法见内容研究。
资料来源
这个问题出现过的地方(读取于 2026-11-15)
更新于