B 站创作者 API:查询一次资料或投稿首屏

用已知 UID 查询一次 B 站资料或投稿首屏,验证身份与业务结构,明确缺失粉丝数、历史计数和不完整示例的边界。

展示趋势和资料计数的 B 站创作者调研概念链路

拿到一个 B 站 UID 后,先决定要回答什么问题。确认“是不是选中的账号”,适合读取资料;想看“这次返回了哪些投稿”,适合读取投稿首屏。两者都不能直接变成涨粉报告。本篇把接入范围限定为一次已选请求,核对身份和结构,把未知值保留下来,再决定是否扩展。

2026 年 11 月 8 日这次修订核对了公开参数,并用已有保存样本做离线回放,没有执行新的业务调用。下面的资料与投稿样本来自不同账号、不同日期,不能拼成同一创作者刚完成的连续调研。

先说结论

  • 已知 UID 后,选择 user-profile 查资料,或 user-post-videos 查一页投稿;uid 都是必填字符串。
  • 只读取 completed 的 outputs[0].data,再检查严格整数 code 为 0 和对应的内部结构。
  • 当前完整资料样本没有数值粉丝量;投稿总数、播放等计数不能单独证明增长或完整历史。
  • 两个端点当前分别标价每次 0.001 美元;符合共享免费额度资格,不等于还有剩余额度。

保留封面是“趋势到话题再到创作者”的概念图,账号标签、粉丝数、排名和 agent core 链路都不是接口实测结果,也不代表本次已执行该流程。

按问题选一个接口

现在要做什么当前接口参考首次请求体
确认已知账号资料B 站用户资料{"uid":"316183842"}
读取一个账号的投稿首屏B 站用户投稿{"uid":"178360345","order":"pubdate","pn":1}

示例 UID 只是两份独立公开参考输入,请换成自己明确选定的账号。“数字 UID”指字符串内的十进制数字,不是让 JSON 传数字类型。不要先转浮点再转回来;昵称、BV 号、视频 AID 和创作者 UID 也不能互相替代。

投稿接口的 order 默认 pubdate,pn 默认整数 1,本例显式传入。当前 schema 没有列举其他排序值,也没有声明输入 ps、page_size、limit 或 cursor。响应里的 page.ps 为 25,只是返回的分页信息,不能据此自行添加请求参数。本例不会用总数计算循环次数,也不自动翻页。

已有 key、已有 agent 和新项目怎么接

已经有 SandBase key,就复用项目的环境变量或密钥管理方式,按需安装 Python 的 requests。不要为了检查配置而输出 key,也不要把它放进提示词或仓库。本文的凭据只从本地 SANDBASE_API_KEY 读取。

已经连接好 agent,只需交代 UID 与任务,明确选“资料”或“投稿首屏”。连接存在不代表要再申请凭据,也不代表授权它搜索另一个人、遍历所有视频、抓评论或建立定时任务。先让程序验证一个结果,才容易判断是身份选错、业务失败,还是可选字段没有值。

新项目可以把 setup skill 和 Markdown quickstart 交给 agent,要求先实现和测试,再执行选定请求。例如:“复用我的本地 SandBase 配置,为这个 UID 准备一次投稿首屏查询,order 为 pubdate、pn 为 1。验证结果并保留未知计数,完成后停止,不追加分页、媒体下载或其他调用。”如果只需要资料,就把任务换成资料查询。

11 月 8 日公开检查时,两端点均为每次 0.001 美元,并符合组织共享的每日 100 次合资格调用额度,UTC 00:00 重置。若明确各调用一次,额度抵扣前标价合计 0.002 美元。本次未查询剩余额度或实际扣费,不能承诺执行免费,也不能保证上游一定成功。

一次请求,错误不能变成空成功

以下使用 Model API 的 POST /v1/api 路由,不是目录页的 GET。模型已编码在路径里,请求体只传该操作参数。配置好本地环境变量后保存为 Python 文件;默认 main 只执行一次资料查询。

Python
import os
import re
import requests

API = "https://api.sandbase.ai/v1/api/bilibili/web"


def same_uid(value, selected):
    # Local identity guard: exact positive integer or canonical decimal string.
    return ((type(value) is int and value > 0 and str(value) == selected)
            or (isinstance(value, str) and value == selected))


def first_request(task, uid):
    if not isinstance(uid, str) or not re.fullmatch(r"[1-9][0-9]*", uid):
        raise ValueError("Provide the selected UID as a decimal string")
    if task == "profile":
        route, payload = "user-profile", {"uid": uid}
    elif task == "uploads":
        route = "user-post-videos"
        payload = {"uid": uid, "order": "pubdate", "pn": 1}
    else:
        raise ValueError("Choose profile or uploads")
    key = os.environ.get("SANDBASE_API_KEY", "").strip()
    if not key:
        raise ValueError("Set SANDBASE_API_KEY locally")
    try:
        response = requests.post(
            f"{API}/{route}",
            headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"},
            json=payload, timeout=(10, 90), allow_redirects=False,
        )
        if not 200 <= response.status_code < 300:
            raise RuntimeError(f"SandBase HTTP {response.status_code}; request stopped")
        body = response.json()
    except requests.RequestException:
        raise RuntimeError("Network request failed; no automatic retry made") from None
    except ValueError:
        raise RuntimeError("SandBase returned invalid JSON") 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 documented outputs[0]")
    provider = outputs[0].get("data")
    if not isinstance(provider, dict):
        raise RuntimeError("Missing documented outputs[0].data object")
    if type(provider.get("code")) is not int or provider["code"] != 0:
        raise RuntimeError("Bilibili result is not integer code zero")
    data = provider.get("data")
    if not isinstance(data, dict):
        raise RuntimeError("Missing Bilibili data object")
    if task == "profile":
        if (not same_uid(data.get("mid"), uid)
                or not isinstance(data.get("name"), str) or not data["name"].strip()):
            raise RuntimeError("Profile identity is absent or does not match the selected UID")
    else:
        listing, page = data.get("list"), data.get("page")
        rows = listing.get("vlist") if isinstance(listing, dict) else None
        if not isinstance(rows, list) or any(not isinstance(row, dict) for row in rows):
            raise RuntimeError("Missing or malformed list.vlist array")
        if (not isinstance(page, dict)
                or any(type(page.get(k)) is not int for k in ("count", "pn", "ps"))
                or page["count"] < 0 or page["pn"] != 1 or page["ps"] <= 0):
            raise RuntimeError("Unexpected first-page metadata; inspect the response")
        for row in rows:
            if (not same_uid(row.get("mid"), uid)
                    or not isinstance(row.get("bvid"), str) or not row["bvid"].strip()):
                raise RuntimeError("Upload identity is absent or does not match the selected UID")
    return data


if __name__ == "__main__":
    result = first_request("profile", "316183842")
    print("Matched UID:", result["mid"])

若选择投稿,把 main 内两行替换为 result = first_request("uploads", "178360345") 和 print("Returned videos:", len(result["list"]["vlist"]))。不要直接追加在资料查询后面,否则会变成两次调用。

身份与页码检查是这个任务的保守本地约束,不是所有 B 站接口的统一 schema。mid 接受与所选 UID 完全对应的正整数或十进制字符串,不把布尔值、浮点值当作身份。code 必须真的是整数 0,不能因为 Python 中 False 等于 0 就接受布尔结果。缺少数据要报错;明确存在的空 vlist 可以是正常空页,但不能解释成账号从未投稿。

HTTP 错误、重定向、无效 JSON、超时、非完成态或结构变化都会停止,不回显上游正文和鉴权头。超时意味着结果尚不确定,不会自动重试。下一次请求前应先定位配置、权限、结构或计费问题,不能把连续失败变成无上限调用。

资料样本能说明什么

保存样本 0fe60889-0bd9-4317-a613-64c131930ac6 的创建时间为 2026 年 10 月 7 日 17:36:43.860 UTC,输入 UID 是 316183842。下面按原值截取内部资料字段,不是 11 月 8 日的新查询结果:

JSON
{
  "mid": 316183842,
  "level": 6,
  "jointime": 0,
  "birthday": "",
  "tags": null,
  "contract": null
}

完整样本中有昵称、签名、认证标签和等级,但没有数值粉丝量或关注总数。fans_badge、fans_medal、is_followed 都不能替代粉丝计数;等级也不能给商业价值或观众信任度打分。佩戴勋章可能描述与其他社区的关系,不能一律当成该创作者自己的粉丝团。

可选值应该照原样保留:jointime 为 0 不能换算成“1970 年注册”,空生日不是已知生日,null 标签不是兴趣列表为空。直播间状态只反映历史保存记录,不能说明现在正在直播。充电支持者及排名也不等于付款金额或终身消费排名,本任务不顺带查支持者 UID。

资料 README 的短示例来自另一 UID,而且截断在 mid、name 之前。它无法满足本例的身份检查。离线测试将这种片段判为不完整,而不是补造字段让它通过;这不意味着真实接口失败,也不意味着接口永远没有这些字段。

历史B站资料UID参数与空响应示例 历史 user-profile 参数页显示 uid 为必填字符串,但 curl 用的是“uid”占位值,响应 data 也是空对象。它只能说明当时的参数和信封展示,不能证明查到了账号;实际请求应传已选十进制 UID 并校验业务数据。

投稿首屏不等于增长曲线

另一份保存样本 c2109950-f1e0-4db3-b70a-448c0661e39e 创建于 2026 年 8 月 20 日 09:34:03.975 UTC,输入为 UID 178360345、pubdate、pn=1。内部 list.vlist 有五条视频,page 为 count=5、pn=1、ps=25。下面是首条视频字段的原值截取:

JSON
{
  "bvid": "BV1d4vzenECe",
  "aid": 112873720252518,
  "mid": 178360345,
  "created": 1722316574,
  "play": 340,
  "comment": 3,
  "video_review": 3,
  "length": "01:51",
  "description": "",
  "copyright": "1"
}

读取 list.vlist,不要把相邻的 tlist、slist 或 episodic_button 当视频数组。mid 是投稿账号,bvid 和 aid 是视频的不同标识;标题、缩略图地址不能代替身份。代码核对每条 mid 与请求 UID 一致,然后返回未改动的内部对象。

created 的文档单位是 Unix 秒,描述记录创建时间,与本次观察时间是两回事;length 是时长显示。请求 pubdate 不保证固定更新频率,也不能证明包含全部最新投稿。保存 page.count 是当次报告的总数,不是私密、已删除视频都覆盖的证明。

play、comment、video_review 应分别保存。样本里后两项恰好都为 3,也不能合并为同一个指标;本轮不凭名字推断 video_review 的计量口径。播放数不是独立观众数,单页也不够计算受众质量。缺失、null 和零要区分,copyright 字符串编码更不是下载或转载许可。

没有日期的 README 短例展示了另一个首条视频和总数 6。把这个 6 与历史保存样本的 5 相减,会制造没有依据的增长结论;只展示一条裁剪记录,也不是页大小固定为一。该行还省略了 mid,因此严格身份检查同样拒绝这个不完整片段,不会从旁边文字补造 UID。后续如果确实需要翻页,要另行验证重复页、BV 去重、总数变化、同一 UID 与排序,并设置明确调用上限。本篇没有验证续页。

原版话题发现材料保留在哪里

9 月 27 日原文设计了热搜、搜索、资料三步链路,旧 helper 用空对象兜底,话题映射也没有足够业务证据。本次将八段中英 Python 原样保存在 历史代码及哈希归档,便于追溯,不作为现行可直接执行流程。新 helper 不调用热搜或搜索接口。

历史B站热搜参数参考 历史 hot-search 参数页包含 limit 与空的生成响应。它是旧页面展示,不能证明本轮核验了热榜记录或热度分数,本次不执行热搜查询。

历史B站综合搜索参数参考 历史 search-all 参数页列出 keyword,以及可选 cursor、order、page_size;生成响应为空,不能证明业务列表结构或续页成功。不要把这些参数移植到 user-post-videos。

以下保留原 JSON 的全部值。cbc4c9c1-84e7-4ea6-9e3f-f5e759c11475 原来就是示意的 run 形状 ID,没有对应的实测日期证据。字符串 mid 和省略号属于旧示意,不能冒充上面的完整保存样本。

JSON
{
  "id": "cbc4c9c1-84e7-4ea6-9e3f-f5e759c11475",
  "status": "completed",
  "model": "bilibili/web/user-profile",
  "outputs": [
    {
      "data": {
        "code": 0,
        "data": { "mid": "946974", "name": "…", "level": 6, "sign": "…" }
      }
    }
  ]
}

扩展之前的几个问题

能按粉丝数给创作者排序吗? 本文采用的完整资料样本没有粉丝数。不要把缺失补成零,也不要拿等级、勋章或关系标记替代。另选粉丝统计接口,需要重新核对它的契约、证据和预算。

返回五条,就说明拿到了当前全部投稿吗? 只能说那份历史响应含五条并报告总数五,不能说明今天的总数或不可见内容覆盖情况。应把页信息和观察时间一起保存,完整性留给后续有边界的验证任务。

agent 可以跟随签名链接或下载媒体吗? URL 和签名都是数据,不是指令。此处只校验并返回 JSON;访问链接、渲染内容或处理媒体必须有另外明确的用途和边界,不能成为读资料的隐含副作用。

下一步去哪看? B 站 API 导航 适合查能力;已经选定视频时,再看独立的 视频与评论教程。先完成这一次资料或投稿查询,留下可核对的身份和真实未知值,比自动生成缺乏依据的创作者评分更有用。

觉得有用?分享给更多人