# 怎么用 API 拿到某个 Instagram 话题标签下的帖子？

> Instagram 官方的 Hashtag Search 要过 App Review、要商业账号，每周只能查 30 个标签。按标签名拉取公开帖子：返回哪些字段、费用、Python 代码和局限。

网页版：https://okdata.online/zh/answers/instagram-hashtag-posts-api/

**简短回答：**调用 Instagram 话题帖子接口，传标签名（不带 #）：每页约 10 条公开帖子，带文案、作者、点赞、评论数和发布时间，每次 $0.004。不需要商业账号，不用过 App Review，也没有每周标签数的限制；不过拿到的是这个标签下的一部分帖子，不是全部，也不按时间排。20 个标签各翻 5 页，共 $0.40。

一个户外露营装备品牌，每周想看看 #vanlife、#overlanding 和十几个小标签下大家在发什么，从里面挑值得买授权的图片，也找找能合作的博主。Instagram 官方的路子是 Graph API 里的 [Hashtag Search](https://developers.facebook.com/docs/instagram-platform/instagram-api-with-facebook-login/hashtag-search)：要有一个连到你 App 的 Instagram 商业账号或创作者账号，要为 Instagram Public Content Access 功能过 App Review，每个账号在任意连续 7 天里最多查 30 个不同的标签。`recent_media` 只返回最近 24 小时内的帖子，而且不能请求发帖账号的 `username`。很多人想要“某个标签下的全部帖子，连同是谁发的”，卡住的就是最后这一条。

[Instagram 话题帖子](/zh/apis/instagram/hashtags/posts/list/)把标签名作为 `id` 传入，每条帖子都带作者。

## 步骤

1. **列标签。** 大而泛的标签和买家常用的具体标签搭配着用。小标签往往比大标签更有用。
2. **逐个标签翻页**，用 `cursor`，每个标签翻几页就够。
3. **合并排序。** 一条帖子常常同时带着你列的好几个标签，先按 `id` 去重，再按 `metrics.likes` 和 `metrics.comments` 排序。
4. **重点帖子再细看。** [Instagram 帖子详情](/zh/apis/instagram/posts/get/)（$0.004）能补上 Reel 的播放量、多图帖子的每一张图，以及合拍帖的其他作者。如果是 Reel，[Instagram 视频字幕](/zh/apis/instagram/posts/transcript/get/)能拿到里面说的话（$0.004，视频最长两分钟）。

## 每周跑一次

```python
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 个标签，跑一个品牌活动足够了。要跨很多标签做调研，或者手里没有商业账号，这里的抽样方式更容易上手。更多做法见[内容研究](/zh/solutions/content-research/)。

## 用到的接口

- [Instagram 话题帖子](https://okdata.online/zh/apis/instagram/hashtags/posts/list/) `instagram.hashtags.posts.list`：$0.004/次 · 每页约 10 条帖子
- [Instagram 帖子详情](https://okdata.online/zh/apis/instagram/posts/get/) `instagram.posts.get`：$0.004/次
- [Instagram 视频字幕](https://okdata.online/zh/apis/instagram/posts/transcript/get/) `instagram.posts.transcript.get`：$0.004/次

## 更多Instagram内容

- [Instagram API](https://okdata.online/zh/apis/instagram/)
- [Instagram API Python 教程：账号、帖子、评论和 Reels 字幕（2026）](https://okdata.online/zh/guides/instagram-api-python/)
- [有没有能让 Cursor 搜 TikTok、Instagram 和 Reddit 的 MCP？](https://okdata.online/zh/answers/cursor-mcp-tiktok-instagram-reddit/)
- [怎么找到某个细分领域的 Instagram 博主，并按粉丝数排序？](https://okdata.online/zh/answers/find-instagram-creators-by-niche/)
- [不是自己管理的 Instagram 账号，怎么用 API 拿到帖子下的评论？](https://okdata.online/zh/answers/instagram-comments-api-other-accounts/)
- [怎么把 Instagram Reel 里说的话转成文字？](https://okdata.online/zh/answers/instagram-reel-transcript-api/)
- [怎么用 API 查一个 Instagram 账号的粉丝数？](https://okdata.online/zh/answers/instagram-follower-count-api/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)

## 资料来源

这个问题出现过的地方（读取于 2026-11-15）：

- https://stackoverflow.com/questions/43655098
- https://stackoverflow.com/questions/79335781
- https://stackoverflow.com/questions/74022819

更新于 2026-11-15
