B站 / Bilibili API - 视频搜索、Bilibili comments、专栏、用户数据

这是社媒数据助手 SocialDataX 的 Apify Actor 适配层，提供只读 B站 / 哔哩哔哩 / Bilibili data API。常见用法包括 Bilibili video search / B站视频搜索、article search / 专栏搜索、content details / 内容详情、Bilibili comments / Bilibili video comments / B站评论导出、comment replies / 评论回复、likes and reposts / 赞转列表、user profiles / 用户资料和用户发布列表。

Apify 用户无需配置 SocialDataX API Key；直接通过 Apify Console、Apify API、Dataset export 或自动化工作流运行即可。

支持能力：

• 视频搜索 / video search
• 专栏搜索 / article search
• 内容详情 / content details
• 评论列表 / Bilibili comments
• 评论回复 / comment replies
• 专栏/动态赞转列表 / likes and reposts for articles and dynamics
• 用户资料 / user profiles
• 用户视频列表 / creator videos
• 用户专栏列表 / creator articles
• 用户动态列表 / creator dynamics

This Actor is a read-only, unofficial data API integration. It is not affiliated with Bilibili.

Support / 联系我们

如果 run 失败、需要更高用量，或想接入批量数据工作流，请通过 SocialDataX support 联系我们：

• Website: https://socialdatax.com/

If a run fails, you need higher limits, or you want to discuss a bulk data workflow, contact SocialDataX support:

• Website: https://socialdatax.com/

选择字段

先选择 operation，再填写该 operation 需要的字段。Apify 表单里其它字段可以留空；即使误填了无关字段，Actor 也会忽略。

Operation	必填字段	可选字段	说明
search_videos	keyword	sort_type, publish_time_range, duration_range, page_token, max_items, auto_paginate	按关键词搜索 B站视频，默认会自动翻页直到达到 max_items。
search_articles	keyword	sort_type, category, page_token, max_items, auto_paginate	按关键词搜索 B站专栏。
get_content_detail	url 或 content_id 至少填一个	无	获取视频、专栏或动态详情；两者都填时优先使用 url。
get_content_comments	url 或 content_id 至少填一个	sort_type, page_token, max_items, auto_paginate	获取视频、专栏或动态的一级评论；两者都填时优先使用 url。
get_content_comment_replies	comment_object_id, comment_object_type, comment_id	page_token, max_items, auto_paginate	获取某条一级评论下的回复。先运行 get_content_comments，从同一条 Dataset 行复制这三个字段。
get_content_likes_and_reposts	post_id 或 url 至少填一个	page_token, max_items, auto_paginate	获取 opus/动态帖子赞转列表；视频链接、BV/av ID、read/cv 或 read/mobile 专栏链接和 cv 专栏 ID 暂不支持。
get_user_info	user_id 或 profile_url 至少填一个	无	获取用户资料；两者都填时优先使用 profile_url。
list_user_videos	user_id 或 profile_url 至少填一个	sort_type, page_token, max_items, auto_paginate	获取用户发布视频列表。
list_user_articles	user_id 或 profile_url 至少填一个	page_token, max_items, auto_paginate	获取用户发布专栏列表。
list_user_dynamics	user_id 或 profile_url 至少填一个	page_token, max_items, auto_paginate	获取用户发布动态列表。

字段填写建议 / Input tips

• keyword: 用于 search_videos 和 search_articles。默认示例是 露营。
• url: 推荐直接粘贴 B站视频、专栏或动态链接，适用于详情和评论。
• content_id: 只填真实内容 ID；如果只有链接，请直接填 url。
• comment_object_id、comment_object_type、comment_id: 只从 get_content_comments 的同一条 Dataset row 复制。不要粘贴内容链接或分享文案。
• post_id: 仅用于 get_content_likes_and_reposts 的 opus/动态帖子赞转列表。请先运行 get_content_detail，再使用 Dataset 行里的 post_id 或 post.share_url；视频链接、BV/av ID、read/cv 或 read/mobile 专栏链接和 cv 专栏 ID 暂不支持赞转列表。
• profile_url: 推荐直接粘贴完整 B站主页链接，例如 https://space.bilibili.com/{id}，适用于用户资料和用户发布列表；用户类 operation 不要填 b23.tv 短链接。
• user_id: 只填 B站数字 user_id / mid，也就是用户主页 space.bilibili.com/{id} 里的数字 ID。不要填昵称、主页名称、BV 号或 aid；如果只有主页链接，请填 profile_url。
• sort_type: 不同 operation 的可选值不同。留空时 Actor 会按 operation 使用默认排序。

如果用户把内容链接填到用户类 operation、把主页链接填到内容类 operation，或在评论回复里粘贴内容链接/分享文案，Actor 会跳过 SocialDataX API 请求并在 OUTPUT 写入中英文 warning 和支持链接，避免因为明显可修正的输入问题直接失败。

输入示例

视频搜索：

{
  "operation": "search_videos",
  "keyword": "露营",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

专栏搜索：

{
  "operation": "search_articles",
  "keyword": "露营",
  "category": "technology",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

内容详情：

{
  "operation": "get_content_detail",
  "url": "https://www.bilibili.com/video/BV1VCVS6PEAd"
}

评论列表：

{
  "operation": "get_content_comments",
  "url": "https://www.bilibili.com/video/BV1FZNW6JEKP",
  "page_token": "",
  "sort_type": "hot",
  "max_items": 20,
  "auto_paginate": true
}

评论回复：

{
  "operation": "get_content_comment_replies",
  "comment_object_id": "1317705",
  "comment_object_type": 12,
  "comment_id": "1124008638",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

用户视频：

{
  "operation": "list_user_videos",
  "profile_url": "https://space.bilibili.com/402951597",
  "page_token": "",
  "max_items": 20,
  "auto_paginate": true
}

max_items 默认 50，最大 1000。auto_paginate=false 时只请求当前 page_token。

如果用户在 Apify run options 里设置了更低的 paid Dataset item 上限，Actor 会把列表类 max_items 自动裁剪到该上限，避免超预算请求过多页面。如果该上限为 0，Actor 会直接结束并在 OUTPUT 写入 warning，不会请求 SocialDataX API。

Apify 计划要求

持续使用需要 Apify paid plan。Apify free plan 用户有 5 次 SocialDataX API request 试用额度；每次请求一个接口页面计 1 次，auto_paginate=true 时每翻一页都会计入一次。试用额度用完后，请升级 Apify 计划继续使用。

Ongoing use requires an Apify paid plan. Free-plan users get a 5-request SocialDataX API trial. Each requested page counts as one request, so auto_paginate=true can consume multiple requests in one run.

输出

Actor 会把结果写入 Apify Dataset，适合 JSON、CSV、Excel / XLSX、JSONL 等格式导出。

列表类接口会为 items[] 中的每个元素写入一条扁平 dataset row：

{
  "operation": "get_content_comments",
  "item_index": 1,
  "query_content_id": "BV1FZNW6JEKP",
  "query_page_token": "",
  "query_sort_type": "hot",
  "query_max_items": 20,
  "query_auto_paginate": true,
  "comment_object_id": "1317705",
  "comment_object_type": 12,
  "comment_id": "1124008638",
  "content": "这个视频很有用。",
  "reply_count": 2,
  "like_count": 9,
  "author_user_id": "20001",
  "author_name": "评论作者",
  "page_request_index": 1,
  "page_item_count": 20,
  "page_next_page_token": "next-token",
  "page_has_more": true
}

详情类接口会写入一条 dataset row。author、user、video、post 等常见对象会展开为 author_*、user_*、video_*、post_* 字段；图片、话题和数组字段保留 JSON 值。

如果某一页 items 为空但仍有分页信息，Actor 会写入一条 empty_page=true 的 summary row，避免丢失 next_page_token。如果空页已经没有下一页，则不会写入 Dataset row。

如果 run 失败，OUTPUT 会保留一条轻量失败摘要，方便在 Apify 控制台里直接看到请求次数、状态码和简要错误信息。

Apify API 调用

同步运行并直接获取 Dataset items：

curl -X POST "https://api.apify.com/v2/acts/socialdatax~socialdatax-bilibili-data-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "search_videos",
    "keyword": "露营",
    "page_token": "",
    "max_items": 20,
    "auto_paginate": true
  }'

Python client 示例：

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("socialdatax/socialdatax-bilibili-data-api").call(run_input={
    "operation": "search_videos",
    "keyword": "露营",
    "page_token": "",
    "max_items": 20,
    "auto_paginate": True,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items

费用

Apify 用户按 Actor 页面展示的 Apify 价格和用量计费，不需要购买或配置 SocialDataX API Key。