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

# 如何搜索 Lemon8 最新视频并保存可追溯的一页结果？

> 使用 lemon8.app.fetch_search（main、video、recent）搜索 Lemon8 最新视频，通过 archive_search.py 校验归档原始响应，并将候选表逐行关联到归档文件与请求号。

搜 Lemon8 最新视频，调用 `lemon8.app.fetch_search`，`search_tab` 用 `main`，`filter_type` 用 `video`，`order_by` 用 `recent`。保存响应，用 `archive_search.py` 校验并归档，在采集清单里记下请求参数。最后交付一份候选表，每一行都关联归档文件和请求号。

例如你在准备一篇防晒补涂内容，手上只有「护肤」这个大方向。先搜一页近期视频，看看作者是在办公室、户外还是带妆后补涂，再选出有实际演示的作品。Lemon8 的[创作者指南](https://www.lemon8-app.com/experience/features-and-uses-of-lemon8-app-for-creators?region=us)也把搜索当作寻找内容形式的入口；用同样的方法给自己的选题找具体问题。

## 怎么把搜索结果交给 AI，变成下周能拍的选题？

1. 搜 `sunscreen reapplication`，只看近期视频。
2. 把入选作品的原链接和你在每条视频里看到的场景放在同一张表里，交给 AI 助手。
3. 提问：「请按补涂场景分组，每组给我一个能实拍的问题。区分实际演示了什么、哪些条件需要我确认。每个选题附来源链接。」

只展示最后妆面的视频可以做画面参考。交代了时间间隔和补涂步骤的视频，可以用来设计自己的对照实验。搜索结果只有标题时，先标成「待看原作」，再决定是否读取作品详情。

## 1. 选择关键词与预算

先用一个关键词跑一页。每换一个词、每多翻一页、每补一次作品详情都单独计费。[BeatAPI 价格页](https://beatapi.io/zh/pricing)

## 2. 获取一页明确筛选的结果

```bash
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"lemon8.app.fetch_search","params":{"query":"sunscreen reapplication","search_tab":"main","filter_type":"video","order_by":"recent","max_cursor":""}}' \
  -o lemon8-search-page-1.json
```

把 `query` 的值换成你的关键词，保留 `main`、`video`、`recent` 三个英文原值。HTTP 请求失败时保留错误并停止。HTTP 成功后，还要在第 3 步检查业务 status。

## 3. 校验并归档

把下面的脚本保存为 `archive_search.py`。BeatAPI 清洗并直接透传搜索 `data`，因此 `archive_search.py` 保存完整的 `data` 和 `request_id`，不假定统一的列表路径。`archive_search.py` 不覆盖已有的归档文件。

```python
import json, pathlib, sys
source, target = map(pathlib.Path, sys.argv[1:3])
r = json.loads(source.read_text(encoding="utf-8"))
if r.get("status") != "succeeded" or r.get("action") != "lemon8.app.fetch_search":
    raise ValueError("Expected successful Lemon8 search")
if "data" not in r or r["data"] is None:
    raise ValueError("Missing query data")
record = {"action": r["action"], "request_id": r.get("request_id"), "data": r["data"]}
with target.open("x", encoding="utf-8") as f:
    json.dump(record, f, ensure_ascii=False, indent=2)
print(str(target))
```

## 4. 检查产物

```bash
python3 archive_search.py lemon8-search-page-1.json lemon8-search-archive-1.json
```

核对归档里的 action 是目标动作、原始 `data` 没有丢失。在采集清单里记录 `query`、`filter_type`、`order_by`、`search_tab`、采集时间和请求的 `max_cursor`。业务成功但结果为空，仍是一次有效的搜索结果；空结果不能证明 Lemon8 上不存在相关内容。

## 5. 受控继续与作品核对

1. 读取返回的 `max_cursor` 和 `has_more`，两个值都保存。
2. 筛选条件保持不变，每一页用新文件名保存。
3. 游标重复或缺失、`has_more` 为 false 或达到页数预算时停止。

对入选作品查详情是额外的调用。搜索结果不是评论数据；读评论还需要 `group_id`、`item_id` 和 `media_id`。

## 6. 把来源与入选理由交给同事

把原始响应和研究表一起交接。例如同事在研究登机箱收纳，可以按下表记录选片理由和下一步。表里的短编号只是行号，真实作品 ID 和原链接写在同一行。

| 行号  | 看到的内容      | 判断与下一步          |
| --- | ---------- | --------------- |
| L01 | 演示把冬衣装进登机箱 | 保留，去核对箱体尺寸和衣物件数 |
| L02 | 只展示装好后的箱子  | 留作画面参考，步骤说明另找   |
| L03 | 只读到了标题     | 待补详情，先保留原标题和来源  |

把每一行关联到归档文件和请求号，再抽查一行能回到原作品。搜索结果为空时，照样保存这一页的筛选条件和响应。

[筛选参数](/zh/faq/lemon8-search-filters) · [链接和评论](/zh/faq/lemon8-links-comments)