# 达人搜索接口

> 2 个平台的 2 个接口，用同一个 Creator 对象返回达人。在平台官方达人广场上按内容方向或名称找达人，可按粉丝数等条件筛选：每位带粉丝数、互动、播放或阅读中位数、内容类目和公开报价。每次 $0.004 到 $0.04，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/creators-search/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音星图达人搜索](https://okdata.online/zh/apis/douyin/xingtu/creators/search/) | `GET /v1/douyin/xingtu/creators/search` | 20 | $0.004/次 · 每页约 20 位达人 |
| 小红书 | [小红书蒲公英达人搜索](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/search/) | `GET /v1/xiaohongshu/pgy/creators/search` | 20 | $0.04/次 · 每页约 20 位达人 |

## 返回的对象：[Creator](https://okdata.online/zh/docs/objects/creator/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `id` | `string` | 达人广场里的达人 ID，其他达人广场接口用它。 |
| `url` | `string` | 达人在达人广场的主页。 |
| `account_id` | `string \| null` | 达人在平台上的账号 ID（达人广场给出时）：抖音是 douyin.users.get 用的 sec_uid（MS4w 开头），小红书是用户 ID。 |
| `username` | `string \| null` | 平台上的用户名或号（有的话）。 |
| `name` | `string` | 昵称。 |
| `avatar_url` | `string \| null` | 头像图片地址。 |
| `location` | `string \| null` | 达人所在地。 |
| `gender` | `string \| null` | 达人广场标注的性别。 |
| `followers` | `integer \| null` | 粉丝数。 |
| `categories` | `string[] \| null` | 达人广场的内容类目，平台原文。 |
| `engagement_rate` | `number \| null` | 近期作品的互动率，0 到 1（0.038 即 3.8%）。 |
| `median_views` | `integer \| null` | 近期日常作品的播放或阅读中位数。 |
| `median_engagements` | `integer \| null` | 近期日常作品的互动中位数（赞、评、藏、转）。 |
| `rates` | `Rate[] \| null` | 公开的合作报价；达人广场不展示时为 null。 |
| `ext` | `object` | 平台特有字段，只在 view=full 时返回。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=户外'

# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=户外'
```

## 常见用途

- 列一份粉丝 1 万到 10 万的露营达人候选名单。
- 发 brief 之前，先拿公开报价和播放中位数对比一下。
- 找出近期互动率高于某个值的达人。

## 常见问题

### 和账号搜索有什么不同？

账号搜索返回的是 App 里的主页信息。达人搜索返回的是达人广场的数据：互动率、播放中位数、内容类目和合作报价。

### 报价就是最终价格吗？

是达人广场上的标价，单位人民币，并注明每种合作形式现在接不接。真正下单在达人广场完成；广场不展示报价时为 null。

### 需要星图或蒲公英账号吗？

不需要。一个 API key 就够了：全程不用登录达人广场，也不牵涉你自己的任何广场账号。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)