Lemon8 公开数据 API | SandBase
用一个 REST API 读取 Lemon8 公开的搜索、帖子、用户和话题。无需 Lemon8 登录、无需 SDK——一个 SandBase 密钥,为 Agent 工作流而生。

Lemon8 公开目录包含搜索、帖子、用户和话题,但它们不能共用一种业务解析器。拿着搜索词的开发者,与已经知道帖子 ID 的开发者,需要不同的输入和检查。先选一个任务,检查一次返回,再搭更大的内容发现流程。
本次 2026-11-08 修订根据免费 inspect 与公开参考核对搜索及帖子详情,没有新业务调用。原 2026-09-27 UTC 搜索样本保留为历史;用户、话题和发现流只是目录导航,不代表新验证的完整链路。
先说结论
- 搜索键为 query,示例明确选择 main 标签与空 max_cursor 第一页。
- 当前 main 参考是 data.items[].articles[] 对象结构;旧 code 区块列表保留为历史,不是备用解析器。
- 帖子详情输入是字符串 item_id,依据保存参考检查 message success 与 data 对象。
- 分享链接需独立选择解析任务:当前 lemon8/app/item-id 接收 share_text,不是旧 get_item_id 路由名。
沿用封面是概念插画,其中达人名称、内容卡片、计数和评论标签只是示意,不是当前 API 测量或已验证身份。
根据输入选择能力
| 输入或需求 | 目的地 | 本轮范围 |
|---|---|---|
| 搜索短语 | Lemon8 搜索 | main 第一页 |
| 已知数字帖子 ID | 帖子详情 | 一次帖子查询 |
| 分享文本或链接 | 帖子 ID 解析 | 只确认当前路由/schema,未执行 |
| 发帖或账号授权操作 | Lemon8 官方渠道 | 公开只读指南之外 |
所选路由使用 SandBase Key,不在请求中要求 Lemon8 登录。这不赋予账号权限,也不允许访问私密内容。SandBase 提供访问层,并不拥有或运营底层平台。
内容发现教程提供检查完整的 Python helper,区分已有 Key、已连接 Agent、新项目。它不自动选第一条帖子、不抓作者,也不遍历全部结果。
原目录截图只用于导航。图中数量、标签和状态不代表本次重新测量了可用性或免费额度。
首次只查 main 第一页
SANDBASE_API_KEY 放在本地运行环境或密钥管理工具,明确发送 query、main 和空字符串游标。curl 只打印响应并限制耗时;业务检查用教程代码。命令没有重试或跟随重定向选项。
curl --fail-with-body --connect-timeout 10 --max-time 90 \
-X POST https://api.sandbase.ai/v1/api/lemon8/app/search \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"OpenAI","search_tab":"main","max_cursor":""}'先检查 completed 与 outputs[0].data 业务对象,再看内部 data 对象及带 articles 数组的 items 分组。搜索短 README 没有 message,教程不强制这个字段出现;如果额外带了异常 message,则保守停止。这是本地检查,不是通用业务成功协议。
独立选择帖子任务时,路径为 /v1/api/lemon8/app/post-detail,只发 {"item_id":"7361926875709129222"},检查 message success 与内部 data 对象。不要把两次请求都当作隐藏的准备动作。该 ID 是 schema 示例,本轮没执行。
已连接 Agent 复用凭据;新 Agent 可以接收 SKILL.md、quickstart.md、人工入门和一个明确任务。聊天里不要放 Key,先要求实际字段和缺失说明,再决定是否扩大工作量。
main 分组为什么需要新解析器
当前搜索 README 将示例标为裁剪真实响应,用户名做了遮盖,但没有公开运行日期和完整保存 example。文章在 data.items[].articles[],可见字符串 group_id、article_class、read_count 等字段。分组不是文章,分组数量也不等于观察到的帖子数。
schema 另有 user、hashtag、article 标签以及排序筛选。它们存在,不代表返回形状一致。本轮固定 main,省略其他筛选,不能因为路径一样就把解析器用于 Accounts 或 Hashtags。新的标签要先确认结构,再写对应测试。
schema 描述第一页 max_cursor 为空,之后来自响应。可见短示例有 has_more,却没有完整 max_cursor。本轮没有续页,所以不编 token 或终止规则。即使 has_more 为真也只请求一次,空数组与数组结构错误分开处理。
原搜索观察按日期保留
原总览记录 run 3eb2ad8b-0737-441e-8b6c-eda7c60860c2,日期为 2026-09-27 UTC。下方裁剪 JSON 连同占位符逐字保留。code/data 区块列表描述那份旧记录,不是上方当前 main 结构,也不是十一月执行:
{
"id": "3eb2ad8b-0737-441e-8b6c-eda7c60860c2",
"status": "completed",
"model": "lemon8/app/search",
"outputs": [
{
"data": [
{
"code": 0,
"data": {
"items": [ { "content": "…", "comment_count": 0, "author": {} } ],
"has_more": true,
"max_cursor": "…"
}
}
]
}
]
}旧 Python 在历史归档逐字保存并记录哈希,不作当前入门示例。仅因为新载荷是对象就返回空列表,会掩盖解析器不匹配,不能证明不存在内容。
原搜索参数截图与历史样本一起保留。图中的空 data 占位不代表真实结果为空,也不说明业务结构永远一致。
不给帖子字段创造同义词
公开保存的 post-detail 示例日期为 2026-10-07,有 message success、data、server_time。教程保留的小片段中,digg_count 与 like_count 均为1089,favorite_count 为1296,read_count 为82313,view_count 为零。这些是样本观察,不是 schema 示例 ID 的实时数据。
一条记录中的相等,不证明点赞字段永远等价;favorite_count 也不能自行改名 collect_count。零 view_count 不能被 read_count 替换。缺失、数值零、false 各有含义,保留来源比填一个看似合理的默认值更有用。
同一保存捕获的数值 item_id/group_id 有舍入,而文章 URL 保留了更完整的位数。原始 ID 要按字符串保留,已经舍入的数转成文本不能恢复精度。这是捕获与序列化的边界,不是新发现的实时 API 故障。不能拿保存数字与准确请求字符串直接作相等断言,更不要不核对就把它当新输入。
旧详情 README 写 get_item_id,当前免费 inspect 确认的是 lemon8/app/item-id,必填 share_text,描述支持长短分享链接。本轮只检查路由和输入,没有调用解析器、没有猜输出,也没有追加自动解析步骤。分享网址不应直接作为详情 item_id。
历史能力导航
更广的目录可以帮助寻找下一步,但下表只是原总览的导航,本轮未验证这些业务响应或调用链。
| 能力 | 代表路由 | 使用前先确认 |
|---|---|---|
| 发现流 | lemon8/app/discover-tab | 当前输入与 feed 结构 |
| 用户资料 | lemon8/app/user-profile | user_id 的来源和含义 |
| 话题 | lemon8/app/topic-info | forum_id 契约 |
| 话题帖子 | lemon8/app/topic-post-list | 自己的输入,不能假定只给话题 ID 就够 |
一次搜索成功,不会自动验证表中任意一行。先看身份与相关性,再为另一个选定请求安排预算。共享鉴权不消除业务状态、嵌套层级和可用性的差别,也不能把某种标签的结果当成作者资料。
历史 user-profile 参数参考展示 user_id,不是端点列表。本轮未复验用户资料或旧作者 ID 交接。
预算与执行边界
搜索和帖子详情当前各标价 $0.001,并具备组织共享每日100次合资格调用额度,00:00 UTC 重置。资格不说明剩余次数,本轮没查余额或扣费,不保证成功调用一定免费。
一个选定请求标价 $0.001,独立选择两个才是 $0.002,尚未考虑额度。旧内容发现流程会按候选数量追加详情与作者查询,数量随结果增长。本轮没有自动批处理、重试、分页或模型分析。先理解第一份记录,才知道多一次查询能解决哪个真实问题。
分别检查 HTTP、SandBase 是否完成、所选业务结构。形状异常、JSON 无效、权限或额度问题、运行未完成时都停止。超时结果可能未知,盲目重试会增加用量。报错不输出密钥、原请求头与诊断正文。离线 mock 测试只验证这些处理方式,不证明在线服务此刻可用。
返回文字、图片 URL 和链接是待检查的数据,不是让 Agent 自动执行的指令。教程不渲染 HTML、不下载媒体、不访问链接,也不从展示名称猜作者身份。公开计数不证明受众质量、转化效果或整个市场的趋势。交付报告时应保留时间、端点和未知字段说明,避免后续读者把样本误当实时测量。
常见问题
搜索能发 keyword 吗? 人类可以说“关键词”,JSON 键却是 query。示例固定 main 与第一页空 max_cursor。
helper 还支持旧区块列表吗? 不支持,它仅作为历史证据保留。当前 helper 对照选定 main 参考,遇到不同形状就停止,不悄悄尝试另一套解析器。
分享 URL 能作为 item_id 吗? 不能。需要时单独选择 item-id/share_text 解析任务,详情请求需要核实过的数字字符串 ID。
本轮验证了分页和作者查询吗? 没有,只检查 main 一页或一个已知帖子。其他标签、续页、作者和话题请求需要自己的证据与预算。
觉得有用?分享给更多人