> 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.

# 怎样整理几家品牌的广告创意，做成能复看的参考表？

> 用 tiktok.ads.search_ads 搜索 TikTok 广告创意，用 tiktok.ads.get_ads_detail 补充入选广告详情，并按各自来源范围整合 Meta、LinkedIn 与 Google 广告库记录。

要做一份有出处的广告创意参考表，用 `tiktok.ads.search_ads` 搜索 TikTok 广告创意，用 `tiktok.ads.get_ads_detail` 给入选广告补详情；手里已有的 Meta、LinkedIn 或 Google 广告库记录，连同各自的来源范围一起放进同一张表。先定好市场、观察日期和品牌范围。交付的表格里，每条创意判断都注明支撑这条判断的广告，同事可以逐条复看。

以下以跑鞋广告研究为例，比较同行如何讲解缓震、鞋重与日常通勤卖点。

## 先拿一小批 TikTok 创意样本

用 `tiktok.ads.search_ads` 搜索创意样本。下面的示例请求检索美国、30 天窗口内与跑鞋相关的一页结果。把请求发到 `POST https://api.beatapi.io/v1/social-data/call`，使用 BeatAPI Bearer 鉴权。

```json
{
  "action": "tiktok.ads.search_ads",
  "params": {"keyword":"running shoes","country_code":"US","period":30,"page":1,"limit":20,"order_by":"for_you"}
}
```

1. 保留原查询条件，记录实际请求的每一页和返回的搜索状态。
2. 响应里明确返回了供继续查询的搜索 ID 时，将返回的搜索 ID 原样传入 `search_id`。
3. 每页的条数按实际返回记录。遇到重复结果、空页或达到计划页数时停止，并记录原因。

创意样本适合研究表达方式；要证明某个广告主在哪些地区投放过，另找实际的广告透明度资料。

入选素材确实需要补详情时，把响应里确认的广告 ID 作为 `ads_id` 传给 `tiktok.ads.get_ads_detail`。详情、素材和落地页按实际响应里的字段记录。调用费用按搜索页数和选中的详情数规划，见[价格页](https://beatapi.io/zh/pricing)。

### 批量找关键词样本怎么记？

例如先查「running shoes」「cushioned running shoes」「commuter running shoes」，每个词两页，共六次搜索。每一页结果单独保留关键词、国家、时间窗口、页码和请求号。筛表时按可确认的广告 ID 去重，同时保留每条素材命中了哪些词。同一条素材出现在两个词的结果里时，素材引用一次，两条查找记录都列出。补详情时，只给已入选的素材发详情请求。

## 已有其他广告库资料时，按各自的出处比

当前 BeatAPI 公开目录没有 Meta、LinkedIn 或 Google 广告透明度的查询动作。已有 Meta、LinkedIn 或 Google 广告库的记录链接或导出时，可以和 TikTok 样本放进同一份研究表，并保留每条记录的具体来源范围。

| 来源             | 先核对什么              | 怎样用                         |
| -------------- | ------------------ | --------------------------- |
| Meta 广告库资料     | 广告主对应的主页、记录中的市场与状态 | 同名品牌先核实，比较指定主页的卖点与素材        |
| LinkedIn 广告库资料 | 实际广告主、公司或子品牌、记录的地区 | 比较不同广告主的标题和行动号召，展示区间保留原档    |
| Google 广告透明度资料 | 广告主身份、记录的地区和素材形式   | 先筛目标市场中可确认的创意，再补实际可见的文案与落地页 |

地区、投放时间、展示量档位和状态都按来源的原值填写，来源页面没有展示的字段留空。广告主身份不明确时，先把目标品牌主页和广告库记录放在一起核对，再合并结果。

## 做成选题或创意简报

表格每行保留以下字段：平台、广告主、素材 ID 或链接、查询范围、正文或画面位置、卖点、行动号召和你的判断。只描述实际看过的素材；候选素材只有图片时，写你在图片里实际看到的内容。多个版本用了同一个主张时，可以归为同一个创意方向，每个版本的原始记录仍各自保留。

例如三条广告都在前五秒展示“通勤穿着”，可以把“开场先给使用场景”作为待尝试的方向，并附上这三条广告。素材只有展示区间、没有转化数据时，报告只讨论广告的表达方式。

再举一例：TikTok 样本 A 开头展示雨天通勤，Meta 档案 B 用通勤作为标题，LinkedIn 档案 C 主打长时间站立。把 A 和 B 归到「通勤场景先讲清楚」，C 留给另一个工作场景。每条记录保留原广告档案和对应的市场。要把建议交给制作团队，可以写「拍一个雨天通勤开场，测试是否更早让人理解使用场景」，并附上 A 的具体画面和 B 的文案位置。