Lemon8 内容发现 API 教程 | SandBase
接入 Lemon8 main 搜索第一页或已知帖子查询,核对嵌套文章、业务状态与字符串 ID,不自动翻页或追加作者请求。

关键词、帖子 ID、分享链接,是 Lemon8 接入时三种不同的起点。旧教程把搜索当成区块列表,自动打开第一条帖子及作者;当前 main 标签参考却是一个对象,文章放在 data.items[] 内。如果继续套旧解析器,文档里明明有文章,也可能被程序悄悄变成“没有候选”。
本文于 2026-11-08 通过免费 inspect 与公开参考修订,没有发起新业务请求。当前只讲 main 标签第一页或一个已知帖子。2026-09-27 UTC 的实验保留为历史,不表示旧链路刚被重跑。其他能力见 Lemon8 API 汇总。
先说结论
- 搜索参数是
query,不是keyword。本例明确传search_tab: "main"与空max_cursor。- main 参考结构是对象下的
data.items[].articles[],不要套到所有标签,也不要保留旧区块列表兜底。- 已知帖子向 post-detail 传字符串
item_id;保存参考显示message: "success"和内部data。- 分享文本是另一种输入:当前解析路由为
lemon8/app/item-id,参数share_text,不作为自动准备步骤。
沿用封面是概念插画,名称、内容卡片、受众数字和分析标签是示意,不是新响应或认证达人;图里的多步循环不是当前的一次请求流程。
先选输入,再选接口
| 你已掌握的信息 | 目的地 | 本文发送的参数 |
|---|---|---|
| 想研究的话题或搜索短语 | Lemon8 搜索 | query、search_tab: "main"、max_cursor: "" |
| 确定的数字帖子 ID | 帖子详情 | 字符串 item_id |
搜索 schema 也描述了 user、hashtag、article 标签,它们各有用途,本轮没有确认各自的返回形状。示例不发送 order_by 和 filter_type,也不声称验证了全部排序筛选组合。main 与空游标虽是 schema 默认值,代码仍显式写出,让范围一眼可见。
发帖、会员操作和账号授权数据应走 Lemon8 官方渠道。SandBase Key 用于所选公开只读路由,不等于获得某个作者的账号权限,也不允许读取私密内容。
原目录截图只作导航背景,不代表当前可用性、额度或一次新业务结果。
沿用你已经完成的配置
已有 Key,就把 SANDBASE_API_KEY 配到项目真正运行的环境或密钥管理工具,不放进聊天、截图、文章和提交。鉴权失败先核对环境,不要让 Agent 自动生成更多凭据或不断重试。
Agent 已连接时,让它复用配置,明确说:“只搜索这个短语的 main 第一页,列出存在的字段,不打开帖子或作者。”已有帖子 ID 则改成单次详情查询。即使返回缺字段,Agent 也知道该在哪里停止。
新项目可把 SKILL.md、quickstart.md和选定任务交给 Agent。人工快速入门说明环境配置。在执行脚本的 Python 环境安装 requests,给 Agent 的文字里不要包含 Key。
一次请求,清楚地失败
import os
import re
import requests
def first_request(task, value):
if task not in ("search", "post"):
raise ValueError("Choose search or post")
if not isinstance(value, str) or not value.strip():
raise ValueError("Supply a nonempty string")
if task == "post" and not re.fullmatch(r"[0-9]+", value):
raise ValueError("item_id must be a numeric string, not a URL or None")
key = os.environ.get("SANDBASE_API_KEY", "").strip()
if not key:
raise RuntimeError("Set SANDBASE_API_KEY locally")
path = "search" if task == "search" else "post-detail"
params = {"query": value, "search_tab": "main", "max_cursor": ""} if task == "search" else {"item_id": value}
try:
response = requests.post(
f"https://api.sandbase.ai/v1/api/lemon8/app/{path}",
headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"},
json=params, timeout=(10, 90), allow_redirects=False,
)
if not 200 <= response.status_code < 300:
raise RuntimeError(f"HTTP {response.status_code}; inspect access and budget before retrying")
body = response.json()
except ValueError:
raise RuntimeError("Response was not valid JSON") from None
except requests.RequestException:
raise RuntimeError("Network request failed; no automatic retry") from None
if not isinstance(body, dict) or body.get("status") != "completed":
raise RuntimeError("SandBase request did not complete")
outputs = body.get("outputs")
if not isinstance(outputs, list) or not outputs or not isinstance(outputs[0], dict):
raise RuntimeError("Missing outputs[0]")
payload = outputs[0].get("data")
if not isinstance(payload, dict) or not isinstance(payload.get("data"), dict):
raise RuntimeError("Expected business object and inner data object")
if task == "search":
# The trimmed main-tab reference has no message; do not require one.
if "message" in payload and payload["message"] != "success":
raise RuntimeError("Unexpected search message; inspect the response")
groups = payload["data"].get("items")
if not isinstance(groups, list) or any(
not isinstance(group, dict) or not isinstance(group.get("articles"), list)
or any(not isinstance(article, dict) for article in group["articles"])
for group in groups
):
raise RuntimeError("Expected main-tab data.items groups with articles arrays")
elif payload.get("message") != "success":
raise RuntimeError("Post business status was not message success")
return payload
if __name__ == "__main__":
result = first_request("search", "OpenAI")
print("Returned data fields:", sorted(result["data"]))要查已知帖子,把最后赋值替换为 result = first_request("post", "7361926875709129222"),保留字段列表输出,不要追加为第二次自动调用。这个 ID 来自当前 schema 示例,本轮没有执行它。
函数返回原业务对象,不自动挑候选,不把缺失 ID 转成字符串“None”,不读作者、不下载图片、不访问链接,也不翻页。items 或 articles 是空数组可以接受;缺数组或数组结构不对,则不能静默当成正常空结果。
搜索检查有明确范围:短 main 参考没有 message,因此代码不强制它出现;如果响应额外带了非 success 的 message,就保守停止检查。这是本地防误用规则,不是断言所有 Lemon8 搜索都采用同一种状态协议。出现新形状时先核对,不能强塞进旧列表解析器。
分组不是帖子,文章也不代表身份已确认
公开搜索 README 把下面这种结构标为裁剪真实响应,部分名称已遮盖,但没有完整保存 example,也没有公开运行日期。这里只保留结构与少数字段,不重复身份文本或帖子网址:
{
"data": {
"has_more": true,
"items": [
{
"articles": [
{
"group_id": "7661250232746885645",
"article_class": "Gallery",
"language": "en",
"read_count": 16
}
]
}
]
}
}这里 item 是含 articles 的分组,不是旧代码假定的帖子本体。若要计数,应数观察到的嵌套文章对象,并与分组数量分开;即便如此,也不保证候选相关或仍可访问。先核对明确身份字段,再决定是否值得查详情。
此参考可见的标识是字符串 group_id。不能把每个 ID 字段都自动改名为 item_id,也不能由作者名字推断作者 ID。详情输入有自己的身份要求,本轮没有执行搜索到详情的业务链,所以不会声称这次交接刚被验证。
分页同样需要边界。schema 描述第一页用空 max_cursor,之后使用响应游标;短示例只有 has_more,没有完整 max_cursor。这里没有依据编一个 token、把它当数字增加,或宣称已测结束条件。即使 has_more 为真,当前 helper 也只查第一页。
帖子字段相似,也不能随意互换
公开保存的 post-detail 示例日期为 2026-10-07,顶层包含 message success、data 和 server_time。下面裁剪片段保留样本计数,省去身份内容、媒体与长标识:
{
"message": "success",
"data": {
"article_class": "Gallery",
"digg_count": 1089,
"like_count": 1089,
"favorite_count": 1296,
"comment_count": 10,
"share_count": 27,
"read_count": 82313,
"view_count": 0
}
}它们是历史参考值,不是当前 schema 示例 ID 的实时指标,也不是本轮新查结果。此样本的 digg_count 与 like_count 相等,不能证明两个字段永远可互换。收藏字段是 favorite_count,不能擅自起名 collect_count。read_count 与 view_count 在这里就不同,不能因为零看起来“不合理”而用阅读数替换。
缺字段是未知,数字零是实际值,false 是布尔状态,三者要分别保存。计数不能直接证明受众质量、转化或近期互动率。比较帖子时记录来源端点和时间,不把一个保存样本包装成基准数据。
原 post-detail 参数截图。当前过程以字符串传 item_id,并检查保存参考的 message/data 结构;图片不是本轮执行结果。
长数字 ID 要从输入起保持完整
Lemon8 ID 可能超过 JavaScript 精确整数范围,应以字符串传入和存储。公开保存捕获里,数值 item_id/group_id 显示为 7613037734357124000,而文章 URL 内保留 7613037734357123615。这是捕获或序列化的精度差异,不是新接口请求改了帖子身份的证据。
已经舍入的数转回字符串,也找不回丢掉的位数。不要拿这个数值捕获和请求字符串做精确相等断言,更不要复制成新请求。保留已核实的原始字符串 ID;只有分享链接时,应把解析器作为另一个明确任务,而不是从偶然出现的数字猜 ID。
旧详情 README 写的是 /lemon8/app/get_item_id。本轮免费 inspect 确认当前为 item-id,必填参数 share_text,描述支持长短分享链接。这里仅纠正契约:没有执行解析器、没有猜它的输出,也没有把解析调用偷偷加到教程里。
原实验留下了哪些事实
2026-09-27 UTC 的搜索 run 4bac9e8a-eeec-49ec-ba84-49feff8e1928 被记录为区块列表,code 零区块有 items,帖子上有 item_id、author_id。这是历史观察,不是当前 main 参考的保证。
原详情 run 814a5872-8dae-4fb9-b7be-c3990afd8da6 记录 data、message、server_time;用户资料 run a3cf09c5-c08c-4ef7-a898-6a22eeb722ef 观察到 followers_count、following_count、digg_count、comment_count、description,以及 error_code/message。作者 ID 在那次旧调用中完成了交接,不保证每种新分组或标签都如此。
全部原 Python 在历史归档逐字保留,附分块哈希。它不是当前运行指引:旧列表结构、自动选第一条、把 None 字符串化、遍历所有帖子详情及作者,都已由上面的首请求流程替代;不声称旧实验被重新执行。
原 user-profile 参数截图。本轮未复验用户资料与作者 ID 交接,它不是搜索或详情之后的必做步骤。
先算请求量,再决定是否扩展
搜索和详情当前均标价 每次 $0.001,具备组织共享每日 100 次合资格调用额度,00:00 UTC 重置。本轮没有查询剩余次数或余额,资格不能保证下一次成功请求免费。
当前示例只发一个选定请求,独立选择两次才是 $0.002,尚未考虑额度。旧 discover 函数先搜一次,再查 N 个帖子详情,并根据作者 ID 是否存在最多加 N 次资料查询:共 1+N 到 1+2N 次,还没算翻页和重试。这只是请求量核算,不是未在本轮核价的用户资料或其他端点总价。
HTTP、SandBase 完成状态与业务结构分别检查。重定向、鉴权、额度、限流、JSON 无效或缺少 data 都会停止。超时结果可能未知,因此不自动重发,避免悄悄增加用量。报错不带原响应正文、请求头或密钥。离线测试验证这些分支,不证明实时服务可用。
扩大任务前的几个问题
能把 query 写成 keyword 吗? 不能。人类描述可以说“关键词”,但选定 schema 的 JSON 键必须是 query。
这个解析器适用于 Accounts 和 Hashtags 吗? 本轮没有确认。本例固定 main,检查分组内文章;其他标签需要独立的结构证据和测试。
分享 URL 可以直接发给 post-detail 吗? 这里输入是 item_id,不是 URL。当前 item-id 解析器接收 share_text,是独立请求,旧 get_item_id 不是当前路由名。
Agent 会自动找最佳帖子或查作者吗? 不会。它只返回一个检查过的搜索页或帖子记录。先核对身份、缺失数据与预算,再从 Lemon8 汇总页选择具体后续任务。
觉得有用?分享给更多人