# 怎么批量查抖音星图达人报价？

> 手上有一批抖音达人名单，想一次查清他们在巨量星图上的植入视频和定制视频报价（元），不用逐个打开主页。做法、费用和代码。

网页版：https://okdata.online/zh/answers/xingtu-creator-rates-bulk/

**简短回答：**按昵称在星图里搜每个达人，结果已经带植入视频和定制视频报价（元），每次搜索 $0.004；要完整报价单的，再按星图 ID 查，每人 $0.04。60 个达人两步都做，共 $2.64。

周一接到需求：客户团队自己挑了 60 个抖音达人，要在周三前拿到报价。一个个打开星图主页抄价格，基本要搭进去一整天，下周价格一变又得重来。每个达人调两次接口，几分钟就能把报价整理成表，客户签约当天早上再跑一遍也不费事。

## 每个达人两步

1. **先在星图里找到人。** 用[抖音星图达人搜索](/zh/apis/douyin/xingtu/creators/search/)，`search_by=name` 按昵称匹配。每条结果已经带粉丝数、近 30 天互动率、播放中位数，以及植入视频和定制视频的报价。只是粗算预算的话，这一步通常就够了。
2. **再拉完整报价单。** 对真正要提案的达人，调[抖音星图达人报价](/zh/apis/douyin/xingtu/creators/rates/get/)，传第一步拿到的星图达人 ID，返回达人在星图上列出的每种合作方式、价格（元）、现在是否接单，以及结算方式。

星图达人 ID 和抖音号、sec_uid 都不是一回事。除非上次跑的时候把 ID 存下来了，否则都得先搜一次。

## 费用

| 步骤 | 调用次数 | 费用 |
|---|---|---|
| 60 个达人按昵称搜索 | 60 | $0.24 |
| 60 份完整报价单 | 60 | $2.40 |
| 合计 | 120 | $2.64 |

手上没有现成名单、要在某个领域里挑人的话，按内容搜一页能拿到 20 个达人和他们的主要报价，每页 $0.004，看 1000 个达人花 $0.20。常见的做法是先宽搜，最后只给入围的 20 个人拉完整报价单。

## 代码

```python
import csv, os, requests

API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}

def get(path, **params):
    body = requests.get(API + path, headers=H, params=params, timeout=60).json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']}")
    return body["data"]

rows = []
for name in ["达人昵称A", "达人昵称B"]:          # 换成你的名单
    hits = get("/v1/douyin/xingtu/creators/search", query=name, search_by="name")["items"]
    if not hits:
        rows.append({"name": name, "status": "星图未找到"})
        continue
    c = hits[0]                                  # 重名时对一下粉丝数
    card = get("/v1/douyin/xingtu/creators/rates/get", id=c["id"])["item"]
    for r in card["rates"]:
        rows.append({"name": c["name"], "followers": c["followers"], "work": r["name"],
                     "price_cny": r["price"], "open": r["available"]})

with open("xingtu_rates.csv", "w", newline="", encoding="utf-8-sig") as f:
    w = csv.DictWriter(f, fieldnames=["name", "followers", "work", "price_cny", "open", "status"])
    w.writeheader()
    w.writerows(rows)
```

## 要注意的地方

- **星图上的是刊例价。** 平台服务费、折扣和打包价都在星图下单时结算，最终成交价可能不一样。
- **不是每个达人都入驻了星图。** 没入驻或没开通商单的搜不到，单独标出来，走别的渠道联系。
- **某类合作暂停接单。** `available` 为 false，表示达人列了这项合作，但现在不接。
- **重名。** 先对粉丝数和头像，别直接用第一条。
- **没有粉丝画像。** 粉丝年龄、性别、地域分布和历史商单，还是要在星图后台看。
- 失败的调用不扣费，见[错误码说明](/zh/docs/errors/)。

## 其他做法

有星图广告主账号的话，后台自带的筛选和导出就是官方途径，签约前要看的粉丝画像也在里面。MCN 机构可以直接报价，打包合作常常低于刊例价。蝉妈妈、飞瓜这类工具不用写代码，也能按类目看达人榜单。名单长、要反复报价，或者要把报价接进自己的表格和 Agent，用接口更省事。想从零开始找新达人，看[找博主](/zh/solutions/creator-discovery/)。

## 用到的接口

- [抖音星图达人搜索](https://okdata.online/zh/apis/douyin/xingtu/creators/search/) `douyin.xingtu.creators.search`：$0.004/次 · 每页约 20 位达人
- [抖音星图达人报价](https://okdata.online/zh/apis/douyin/xingtu/creators/rates/get/) `douyin.xingtu.creators.rates.get`：$0.04/次

更新于 2026-11-12