> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 做抖音星图合作，怎样先选对达人，再准备可比较的报价资料？

> 从合作内容要求找达人，确认星图作者身份并取商业卡片，再按合作形式、单位和信息时点整理报价与待核项。

想在巨量星图挑抖音合作达人，先用 `douyin.xingtu_v2.search_creator` 按内容或昵称搜候选，挑出有相关作品的人，再用已核对的星图作者标识调 `douyin.xingtu_v2.get_author_business_card_info` 查商业卡片。比如为料理锅找一条完整做菜演示，先看谁能讲清备料、操作和成品，再核对对应交付形式和报价。

给合作同事的名单每人一行，写清代表作品、入选理由、卡片里实际可用的报价和仍需确认的档期。自己的订单、付款或结案数据，在有权限的星图后台查看。

## 星图资料适合帮你决定什么？

巨量星图用于品牌与创作者合作。做一轮达人初筛时，按内容或昵称发现候选，再用已确认的星图作者标识查看商业卡片。卡片里实际有合作形式或商业资料时，把商业资料和代表作品一起交给同事。合同报价、合作档期、受众和表现如果影响决策，分别确认对应资料和观察时点。

准备正式合作时，用同一种交付形式比较报价，另列交易确认后的金额。比如料理锅教程需要完整演示，就先找能演示步骤的达人，再核对教程形式对应的资料。

## 1. 先写这次合作需要什么

例如希望做一道完整示范，或在日常内容里讲一个使用步骤。记录内容目标、形式、交付范围和时间要求，再找代表作品核对。这些要求是你的合作 brief，不是 API 普遍支持的筛选字段。

先从少量相关候选开始，内容明显不符的不用继续补整套资料。

## 2. 按内容或昵称发现作者

新版 `douyin.xingtu_v2.search_creator` 支持 `seach_type`：2 按昵称，3 按内容。参数名按合同写成 `seach_type`，不是 `search_type`。

下面按美食内容找首批候选：

```json
{
  "action": "douyin.xingtu_v2.search_creator",
  "params": {"keyword": "美食", "seach_type": 3, "page": 1}
}
```

通过 `POST https://api.beatapi.io/v1/social-data/call` 提交，使用常规 BeatAPI Bearer 鉴权。已有明确作者时直接定位，按昵称找人用模式 2；旧版搜索只按昵称的说明，不适用于新版的内容搜索模式 3。

保存实际条件、时间、原响应和请求号。读结果时核对每位作者的身份和作品，保留选择理由。星图作者标识与抖音 uid、sec_uid 分别记录，不按看起来相同的数字自行转换。

## 3. 对选中对象取得商业卡片

确认商业卡片动作使用的星图作者标识后，用 `o_author_id` 请求：

```json
{
  "action": "douyin.xingtu_v2.get_author_business_card_info",
  "params": {"o_author_id": "<confirmed_creator_author_id>"}
}
```

先核对实际卡片里的作者、合作形式和商业资料，再把能确认的信息放进下表。固定报价字段和“搜索结果 → 作者标识”的自动映射目前都没有登记，所以要逐张卡片核对；取得卡片后仍要确认报价资料是否齐全。

专用旧报价动作 `douyin.xingtu.kol_service_price_v1` 另外要求 `kolId` 和 `platformChannel`；`kolId` 与新版作者字段的对应关系、渠道取值和输出都需要分别确认。这些证据齐备之前，没有完整的自动报价矩阵，本页先把候选和已得资料整理好。

## 4. 报价资料怎样放在同一张表？

下面是自己定义的对照列，不是原响应承诺的统一键：

| 列          | 核对依据                  |
| ---------- | --------------------- |
| 作者与来源      | 确认的星图对象、卡片/原件及请求号     |
| 内容适配       | 代表作品和具体合作目的           |
| 合作形式       | 实际提供的是哪一种内容或服务        |
| 报价原值、币种与单位 | 保留原值，单位不明的先待核         |
| 结算与接单信息    | 以实际提供资料为准，缺失不当作零或开放状态 |
| 取得时点与适用条件  | 当前观察、时间要求与其他明确说明      |
| 下一步        | 保留、补资料、或排除，并写原因       |

两位作者的不同合作形式分行记录。某项没有固定金额时，不能填 0 元；没有接单标志，也不能推断可以立即合作。目录信息、当前报价、实际合同成交金额和效果预估分别记录。

## 5. 怎样决定值得继续研究谁？

先看内容能否满足 brief，再看同一合作形式下的报价条件是否齐全。一位作者内容非常贴合但资料不完整时，下一步是补相关条件；另一位金额较低但没有相应内容证据时，保留这个差异，不自动评为最优。

需要评估表现时，选同类、同口径的内容和观察。预估播放或互动只是预估材料，不当作本次合作已实现的结果，也不从粉丝数反推保证效果。

把研究交给助手时，可以这样写：

> 按料理锅实操内容需求找星图候选，用实际作品说明内容匹配。对入选者取可用商业资料，按合作形式保留报价原值、单位、时点和缺口。每位给出继续研究理由与待核项，不只做金额排名。

数据查询价格见[价格页](https://beatapi.io/zh/pricing)，与达人合作报价分开计算。已有的作者和卡片原件直接复用，只按入选者的实际缺口补资料。

## 粉丝段、预期 CPM 和报价怎样一起筛？

下例从美食内容中取一页粉丝数在 90 万到 110 万之间的星图候选，预期 CPM 上限用示例值 80。按你自己同一合作形式的预算替换示例值；只看粉丝段时，去掉 `cpm_max`。

```json
{
  "action": "douyin.xingtu_v2.search_creator",
  "params": {
    "keyword": "美食",
    "seach_type": 3,
    "page": 1,
    "fans_min": 900000,
    "fans_max": 1100000,
    "cpm_max": 80
  }
}
```

需要多页时，保留搜索方式、搜索词和筛选条件，按实际页号继续。首轮按已确认的作者标识去重，标注内容适配、报价完整度和实际样本范围。选中后按第 3 节补卡片。只有合作形式、币种、单位和适用条件一致的报价，才进入本批的中位数和范围。比如本批 12 位只有 7 位有可比报价，就写“7 位样本的中位数”。

预估 CPM 用于比较同一口径下的成本。资料给出可比报价和对应的预估播放时，按 报价 ÷ 预估播放 × 1,000 复算，并注明两项依据。播放预测缺失、为零或与合作形式对不上时，标为待核。搜索合同提供 CPM 上下限，排序字段示例是综合分 `score`。取得定义明确的可比 CPM 后，在自己的表里排序。

## 植入和定制怎样比？

可以在 brief 里分出两类：一类是在创作者常规内容里植入产品，另一类是围绕品牌要求专门制作视频。对照实际资料上的合作名称和交付要求，记录修改轮次、授权和报价适用时间。搜索输入 `price_type` 按合同描述的时长档位填写。比较植入和定制时，使用卡片或报价资料里能确认的合作形式和金额。

## 手里只有一条视频链接怎么办？

先按[作品标识](/zh/faq/douyin-video-id)确认普通作品和发布账号。已有确认的星图报告 `item_id` 时，按[作品报告读法](/zh/guides/douyin-share-snapshot)补视频资料。当前星图报告合同没有固定的“视频链接 → 星图作者 ID”输出路径，按四步找星图作者：

1. 把发布者当作候选线索。
2. 在星图用昵称模式搜索发布者的昵称。
3. 用星图主页或代表作品核对是不是同一人。
4. 只把确认后的星图作者 ID 交给商业卡片动作，无法确认的保留待核。

## 星图资料字段怎样与合作任务对照？

对已核实的星图作者，基础资料用 `douyin.xingtu_v2.get_author_base_info` 查，粉丝分布用 `douyin.xingtu_v2.get_author_fans_distribution` 查，两个动作的输入都是 `o_author_id`。普通作品表现另接[作品报告](/zh/guides/douyin-share-snapshot)。每类资料保留原件和时点，返回里未文档化的评分、转化和比例标为待核。问题涉及你自己的订单、资金或结案时，先查你已授权的后台资料。

同一个品牌在两个平台比较达人时，可以共用合作目标、案例证据和下一步这几列。星图和[蒲公英](/zh/guides/xiaohongshu-creator-shortlist)的作者标识、报价形式和指标口径各自保存。CPM 或 CPE 只有在分子、分母、币种和观察范围一致时，才放进同一个排序。