Lemon8 内容发现 API 教程 | SandBase

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

深色电影质感画面:Lemon8 关键词搜索化为一张帖子卡和一张作者资料卡,汇入 Agent 内核

关键词、帖子 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 用于所选公开只读路由,不等于获得某个作者的账号权限,也不允许读取私密内容。

历史 Lemon8 目录 原目录截图只作导航背景,不代表当前可用性、额度或一次新业务结果。

沿用你已经完成的配置

已有 Key,就把 SANDBASE_API_KEY 配到项目真正运行的环境或密钥管理工具,不放进聊天、截图、文章和提交。鉴权失败先核对环境,不要让 Agent 自动生成更多凭据或不断重试。

Agent 已连接时,让它复用配置,明确说:“只搜索这个短语的 main 第一页,列出存在的字段,不打开帖子或作者。”已有帖子 ID 则改成单次详情查询。即使返回缺字段,Agent 也知道该在哪里停止。

新项目可把 SKILL.md、quickstart.md和选定任务交给 Agent。人工快速入门说明环境配置。在执行脚本的 Python 环境安装 requests,给 Agent 的文字里不要包含 Key。

一次请求,清楚地失败

Python
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,也没有公开运行日期。这里只保留结构与少数字段,不重复身份文本或帖子网址:

JSON
{
  "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。下面裁剪片段保留样本计数,省去身份内容、媒体与长标识:

JSON
{
  "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 是布尔状态,三者要分别保存。计数不能直接证明受众质量、转化或近期互动率。比较帖子时记录来源端点和时间,不把一个保存样本包装成基准数据。

历史 Lemon8 帖子详情参考 原 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 字符串化、遍历所有帖子详情及作者,都已由上面的首请求流程替代;不声称旧实验被重新执行。

历史 Lemon8 用户资料参考 原 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 汇总页选择具体后续任务。

觉得有用?分享给更多人