皮皮虾公开数据 API | SandBase
选择皮皮虾榜单列表或详情 API,核对响应、每日指标、精确 ID 与价格,明确一次快照的边界。

接入皮皮虾热榜,先分清要“看看有哪些榜单”,还是“读取已经选定的一个榜”。列表预览帮你决定研究对象,详情给出某榜的一次快照。两者都不能仅凭一次结果证明某条帖子正在上涨。
本次 2026-11-08 修订通过免费 inspect 和公开参考样本核对这两个端点,没有新的业务调用。下方继续保留 2026-09-27 UTC 的原榜单列表记录。搜索、用户和帖子能力仍可通过目录查找,但本轮没有复验它们的业务结构或整条链路。
先说结论
- 列表发送空对象,读取 data.boards;详情发送整数 block_type,读取 data.board。
- SandBase 业务负载位于 outputs[0].data,必须检查 completed、整数 status_code 零和所选集合结构。
- 每日神评点赞与播放不是同一指标;保留 item_info、精确字符串 ID 和 null。
- 应用导航链接不是续页参数;本文不展开全部榜单,不下载媒体,也不调用统计或增加播放量操作。
沿用封面是概念插画,达人名称、卡片和计数只是示意,不是本轮核实的身份或测量结果;LIVE、实时等标签不是经测量的时效保证。
按问题选择公开读取
| 你想知道 | 端点 | 输入 | 检查位置 |
|---|---|---|---|
| 有哪些榜单预览? | 榜单列表 | {} | data.boards 及各榜 board_items |
| 已选的榜里有什么? | 榜单详情 | {"block_type":12} | data.board 及 board_items |
所选请求使用 SandBase Key,而不是皮皮虾账号会话。SandBase 提供接入层,不拥有或运营皮皮虾;这里不是官方合作声明,也不是账号授权工作流。公开读取不能赋予访问私有信息或代表平台用户执行操作的权限。
列表未声明请求参数,详情只要求整数 block_type,示例为 12,没有 cursor、page、limit。旧描述提到 /fetch_hot_search_board_list,应改用真实 /v1/api/pipixia/app/hot-search-board-list,不要把旧函数名当 URL。Python 快照教程分别检查这两种业务结构。
历史皮皮虾目录截图,仅保留导航背景。旧 GET 标签、目录路径和端点数量不是当前执行契约或最新可用性检查。
在已有配置上发一个请求
把 SANDBASE_API_KEY 保存在运行环境或密钥管理器。已连接的 Agent 复用配置,选择一个请求即可。新项目可以接收 SKILL.md、quickstart.md 和快速开始,同时说明要预览还是特定榜型。先让它报告实际返回字段,再决定是否扩大工作量;不要把密钥贴到聊天里。
curl --fail-with-body --connect-timeout 10 --max-time 90 \
-X POST https://api.sandbase.ai/v1/api/pipixia/app/hot-search-board-list \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'这个命令只打印一次响应,不代替业务校验。教程 helper 增加超时、拒绝跳转、HTTP 与 JSON 错误处理、严格 provider 状态及集合检查。独立读取详情时,改选详情 URL 和 {"block_type":12},不要加入 model、关键词或猜测的翻页字段。
传输层 completed 还不够:outputs[0].data 必须是对象,内部 status_code 必须是整数零,data 也必须是对象。列表要有 boards 数组;详情要有 board 对象、board_items 和匹配榜型。明确返回空数组与字段缺失、结构损坏不同,不能把 provider 错误转换成“成功但没有内容”。
保留原始观测,不改写成新实测
原榜单列表运行 08d73dd2-2498-47aa-8cdc-87056e1426d1 记录于 2026-09-27 UTC,下面逐字保留。其计数是历史值,不描述今天的榜;文章修订日期也不是新的调用日期。
{
"id": "08d73dd2-2498-47aa-8cdc-87056e1426d1",
"status": "completed",
"model": "pipixia/app/hot-search-board-list",
"outputs": [
{
"data": {
"status_code": 0,
"message": "success",
"data": {
"boards": [
{ "board_items": [ { "item_info": "今日神评点赞", "today_digg_num": "4375" } ] }
]
}
}
}
]
}当前公开 README 样本同样展示 status_code 零与 message success,列表使用 data.boards,详情使用 data.board。所选条目显示“今日神评点赞”、today_digg_num 1915、today_show_num null。这些是保存的参考值,不是本轮测量。旧摘录的字符串计数和较新参考里的数字计数,应保留各自原类型,不能悄悄拼成一条刚测出的时间序列。
历史榜单列表参数与信封参考。图中 model 请求字段是历史展示,当前列表发送空对象。图里的空业务示例不代表缺少集合也有效;当前正文区分公开参考结构与旧截图。
先解释榜,再比较数字
每个值都要带着 item_info 和字段名。每日高亮评论点赞不是帖子累计获赞,也不是视频播放;today_show_num 为 null 不等于零,评论对象缺失也不能证明帖子无人评论。不要挑一个非空数字就统一命名为“互动量”,那样会同时丢掉单位和观测依据。
每条记录还应保留 block_type、可用榜名和采集时间。数组顺序是这一榜、这一份快照里的位置,不是所有榜的全局排名。同一帖子可能出现在不同榜,仅按 item ID 建字典会覆盖上下文。下一份快照没有出现,应记为未观察到,而不是已删除或一个虚构的末位。
优先保留精确 item_id_str。公开保存样本在浏览器展示的数值 item_id 有精度损失,已舍入数字再转文本无法恢复真实标识。没有字符串时应保留身份未知,不从数字展示中猜 ID。这是保存表示的边界,不是声称刚执行的 API 把标识损坏了。
高亮评论的 city_name 是显示地区标签,不是作者住址或受众地域比例。签名封面和头像 URL 可能过期,读到地址不代表下载完成,也不证明有权转载。本任务保留响应字段,不追加媒体请求。
目录导航与执行流程分开
更广的皮皮虾目录包括搜索、用户和帖子。下表延续历史导航,不表示本轮重新测试了参数或返回结构:
| 能力 | 代表路由 | 开始独立任务前 |
|---|---|---|
| 搜索 | pipixia/app/search | 核当前输入和结果结构 |
| 用户资料 | pipixia/app/user-info | 核标识来源与返回字段 |
| 帖子详情 | pipixia/app/post-detail | 核帖子 ID 与业务响应 |
| 用户帖子 | pipixia/app/user-post-list | 单独核对翻页契约 |
统一鉴权并不会统一所有业务负载。榜单成功不能替搜索、资料、统计或写操作做验收;也不能把榜单 parser 套到所有路由。看到预览条目后,不应隐式抓作者、全部帖子或附加统计,这些需要另外明确问题和预算。
历史皮皮虾搜索参数参考,不是端点列表截图。搜索输入与续页行为不在本轮榜单修订的复验范围内。
所选榜单负载里的 has_more_text 和 has_more_schema 是应用导航提示,不是已验证的 API 游标。详情 schema 没有分页字段,单次流程拿到集合后就停,不跟随 bds 链接,也不编造 offset。这里没有承诺穷尽榜单全部条目。
价格与请求量
2026-11-08 免费 inspect 显示两个端点均为 $0.001,符合组织内合格 API 每日共享 100 次额度,00:00 UTC 重置。符合资格不能告诉你还剩多少次;本轮没查余额和真实扣费,不作免费成功保证。额度重置也不能推导 provider 的“今日”从何时开始。
选一个请求标价 $0.001;独立选择列表和详情才是 $0.002,尚未考虑额度。轮询、自动重试和逐榜展开都会增加次数。当前教程刻意只发一次请求并停止,让你先判断连续采样是否真的能回答研究问题。
常见问题
本文已经实现定时监控了吗? 没有,它准备的是经过校验的快照。周期监控还要定义采样规则、存储、包含榜型的匹配键和预算。本轮没有新的多次趋势测试,也没有创建调度任务。
完整榜单链接能当游标吗? 不能据此推导有效 API 续页。详情选择一个整数 block_type;所选 schema 没有 page、cursor 或 limit。
读榜会顺便增加帖子播放量吗? 本流程没有调用增加播放量操作。目录可能列出其他能力,但当前只选列表或详情,不调用统计、下载或后续动作。
原来的 Python 在哪里? 已逐字保留在历史归档,并附哈希。原先允许缺失状态、回退空列表的做法由严格教程 helper 替代,历史证据仍可查阅,但不再被当作当前指引。
觉得有用?分享给更多人