核心接口

哔哩哔哩用户作品 API

哔哩哔哩用户作品接口(user_posts):每次成功调用 0.2 credits,支持 HTTP 与 Remote MCP,输入、数据来源和计费规则清晰。

01 / 核心接口

一次请求

成功或空结果每次 0.2 credits,失败不计费。

把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板,不会自动执行。

请求模板
curl --request POST 'https://api.socialtoai.com/v1/user_posts' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"bilibili","user":"PASTE_PUBLIC_ACCOUNT_ID"}'

02 / 核心接口

原生支持

结果类型:item。翻页:使用返回的不透明 cursor。

以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准,不要假定不支持的筛选已生效。

03 / 核心接口

经过结构校验的示例

示意结果,只含一条虚构数据和示例试用余额,用来展示响应结构,不是实时结果,也不代表线上可用率。

示意 JSON · 非实时
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "item",
      "id": "EXAMPLE_ITEM_ID",
      "author": {
        "name": "example_author"
      },
      "published_at": "2026-09-01T08:30:00Z",
      "metrics": {
        "likes": 412,
        "comments": 96
      },
      "title": "Illustrative post title",
      "text": "Illustrative excerpt, not real content."
    }
  ],
  "platform": "bilibili",
  "billing": {
    "cost": 0.2,
    "balance": 1.8,
    "unit": "credits",
    "pricing": "standard"
  }
}

04 / 核心接口

平台限制

搜索返回视频。不支持的热度排序会回退为综合排序;图文筛选回退为视频,并附带 warning。

每次搜索最多读取 20 条原生记录。默认 count=20 时可以直接翻到下一个原生页;过滤非视频或重复记录后,返回条数可能少于请求数。

count 较小时,翻页会继续读取同一源页面的剩余部分。如果上游条目或顺序发生变化,翻页会以 upstream_error 失败且不扣费。不保证快照稳定;网关不会自动重试或放大 count。

作品请使用 BV 号、标准视频链接或 b23.tv 分享链接;账号请使用数字 UID 或 space.bilibili.com 主页链接。

评论翻页和回复分支请原样传入返回的不透明 cursor。

常见问题

这个调用多少钱?

成功或空结果每次 0.2 credits,失败不扣费。

可以翻页吗?

只使用返回的不透明 cursor,并保持平台和查询不变。请检查 has_more 和剩余预算。

平台的所有功能都覆盖了吗?

搜索返回视频。不支持的热度排序会回退为综合排序;图文筛选回退为视频,并附带 warning。每次搜索最多读取 20 条原生记录。默认 count=20 时可以直接翻到下一个原生页;过滤非视频或重复记录后,返回条数可能少于请求数。count 较小时,翻页会继续读取同一源页面的剩余部分。如果上游条目或顺序发生变化,翻页会以 upstream_error 失败且不扣费。不保证快照稳定;网关不会自动重试或放大 count。作品请使用 BV 号、标准视频链接或 b23.tv 分享链接;账号请使用数字 UID 或 space.bilibili.com 主页链接。评论翻页和回复分支请原样传入返回的不透明 cursor。

你的 AI,更广的视野

从一个好问题开始。

领取 2 个免费 credits ↗

无需绑卡。只读公开数据。限制明确,计费透明。