# 如何查询抖音星图达人报价

用 2 个接口：抖音星图达人搜索 → 抖音星图达人商业报价。下面的示例一共 6 次调用，合计 $0.204；失败的调用不收费。

按昵称在星图上搜到达人，再取他的商业报价：每种合作形式的价格、结算方式、现在接不接。投放前比价、筛达人都用得上。

## 一步一步做

### 第 1 步：抖音星图达人搜索

按昵称里的词搜星图达人，一页 20 位。每条的 `id` 是星图达人编号，下一步要的就是它。加 `view=full` 还能先看到 21 到 60 秒、60 秒以上两档视频的报价（`ext.rate_21_60s`、`ext.rate_over_60s`）和预估播放数（`ext.expected_views`），用来粗筛。（[抖音星图达人搜索](https://dataxapi.com/zh/apis/douyin/xingtu/creators/search/)，$0.0040 / 一次）

cURL

```bash
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/search" \
  --data-urlencode "query=美食" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.xingtu.creators.search(query="美食")
print(result["data"]["items"])
```

TypeScript

```typescript
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.xingtu.creators.search({ query: "美食" });
console.log(result.data.items);
```

命令行

```bash
dataxapi call douyin.xingtu.creators.search 'query=美食'
```

录制的返回：取自 2026-10-12 22:06 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

```jsonc
{
  "code": "ok",
  "request_id": "868ddbde-b3c7-4d7f-b06d-9222e36252a7",
  "data": {
    "items": [
      {
        "id": "6811001738597474041",
        "name": "橘子汽水不加冰",
        "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_49724ca5b7a50c72cbe5.jpeg",
        "location": "北京",
        "categories": ["户外"],
        "subcategories": ["家居好物"],
        "metrics": { "followers": 48169 }
      },
      // … 另有 19 条
    ]
  },
  "page": {
    "next_cursor": "c1.Xg3q38In7offq-5CuKi-UcARHThe6dxGEKhgaR5D",
    "cursor_expires_at": "2026-10-12T23:06:50.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T22:06:50.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": { "account_id": "capability", "username": "capability" },
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    }
  }
}
```

### 第 2 步：抖音星图达人商业报价

把星图达人编号放进 `id`，返回这位达人每种合作形式的报价。`rates` 里每条有合作形式 `name`、报价 `amount`、结算方式 `settlement`，`open` 说明现在接不接这种合作。（[抖音星图达人商业报价](https://dataxapi.com/zh/apis/douyin/xingtu/creators/rates/get/)，$0.0400 / 一次）

cURL

```bash
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/rates/get" \
  --data-urlencode "id=6629656444889202692" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.xingtu.creators.rates.get(id="6629656444889202692")
print(result["data"]["item"])
```

TypeScript

```typescript
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.xingtu.creators.rates.get({ id: "6629656444889202692" });
console.log(result.data.item);
```

命令行

```bash
dataxapi call douyin.xingtu.creators.rates.get id=6629656444889202692
```

录制的返回：取自 2026-10-10 14:02 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

```jsonc
{
  "code": "ok",
  "request_id": "ad52d689-43bc-419f-8e8d-fee750a32290",
  "data": {
    "item": {
      "creator_id": "6187694769211204659",
      "currency": "CNY",
      "rates": [
        {
          "name": "植入视频",
          "amount": "400000",
          "settlement": "固定价格",
          "open": true
        },
        {
          "name": "定制视频",
          "amount": "500000",
          "settlement": "固定价格",
          "open": true
        },
        // … 另有 4 条
      ]
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.rates.get",
    "result_status": "complete",
    "fetched_at": "2026-10-10T14:02:30.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.04",
      "currency": "USD",
      "balance_after": "9.96"
    }
  }
}
```

## 示例花多少钱

搜一页星图达人（20 位），挑 5 位取完整报价

| 接口 | 调用次数 | 单价 | 小计 |
| --- | --- | --- | --- |
| [抖音星图达人搜索](https://dataxapi.com/zh/apis/douyin/xingtu/creators/search/) | 1 | $0.0040 | $0.0040 |
| [抖音星图达人商业报价](https://dataxapi.com/zh/apis/douyin/xingtu/creators/rates/get/) | 5 | $0.0400 | $0.20 |
| 合计 | 6 |  | $0.204 |

价格是生成本页时的现行价格。失败的调用、不存在的对象都不收费。

## 在 AI 里做（MCP）

把 DataXAPI 接进你的 AI 客户端，只要接一次。之后直接说要什么，代理自己找到这些接口、看好价格，用你的余额调用。

这样说：在抖音星图搜“美食”相关的达人，挑粉丝最多的 5 位，把他们每种合作形式的报价和结算方式列成一张表。

代理发给 call 工具的参数：

```json
{
  "capability": "douyin.xingtu.creators.search",
  "query": "美食",
  "idempotency_key": "<a new UUID>"
}
```

[了解 MCP 服务](https://dataxapi.com/zh/mcp/)

## 要知道的

- 星图达人编号是一串数字，和抖音账号编号不是一回事，其他星图接口要的也是它。搜索结果里没有抖音账号编号和抖音号（`account_id`、`username`），要的话用星图达人资料接口按编号取。
- 报价的货币看 `currency`。没有固定价的合作形式（比如按播放量结算的），`amount` 是 `null`。
- 搜索按达人昵称匹配，不按内容；`page.next_cursor` 一小时内有效。搜索没有结果也照常扣费；报价接口取不到报价时不扣费。

## 用到的接口

- [抖音星图达人搜索](https://dataxapi.com/zh/apis/douyin/xingtu/creators/search/)
- [抖音星图达人商业报价](https://dataxapi.com/zh/apis/douyin/xingtu/creators/rates/get/)

## 抖音的更多内容

- [抖音 API](https://dataxapi.com/zh/apis/douyin/)
- [抖音星图 API](https://dataxapi.com/zh/apis/douyin/xingtu/)
- [如何批量获取抖音关键词热度趋势](https://dataxapi.com/zh/guides/douyin-keyword-trends/)
- [如何批量导出抖音视频评论](https://dataxapi.com/zh/guides/douyin-video-comments/)
- [抖音数据怎么导出？](https://dataxapi.com/zh/answers/export-douyin-data/)

---

目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/guides/douyin-xingtu-creator-rates/)