POST
接口健康状态
- 24h 健康值
- 100%
- 24h 平均耗时
- 3.00 s
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
健康
24 小时趋势
30 天趋势
关键词搜索：返回列表，默认 20 条、单次最多 50 条；主要字段 id、url、title、text、duration_seconds、duration_sec。
请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 bilibili，action 填 search。 单价 $0.56 / 千次（每次 $0.000556），失败和空结果都不收费。 同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。
B站关键词搜索按 keyword 检索视频，返回标题、简介、时长、播放、点赞、评论、弹幕、收藏、投币和分享数，以及分区、标签、UP 主和发布时间。它回答「这个主题在 B 站上有哪些视频、哪些最受欢迎」，适合做选题研究、品牌声量观察和寻找合作 UP 主。
用 sort 按综合、最新、播放量或评论排序；注意 most_liked 实际是收藏优先，不是按点赞量排序。比较热度时可以多看 coin_count：投币是 B 站用户的付费级好评，比点赞含金量高；danmaku_count 和评论数并列，能反映观看时的活跃程度。
AI 提示词
#请帮我用 EveryInfra 的「B站关键词搜索」接口（bilibili/search）写一个数据采集脚本。
接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 bilibili，action 填 search，参数放在 params 里。
- 必填参数：
- keyword：B 站视频搜索词，可填视频标题或主题；不是 UP 主昵称精确查询。查询 UP 主资料或投稿请使用 user_id。
- 可选参数：
- sort：视频排序：relevance 综合、newest 最新、most_viewed 播放量、most_commented 评论相关、most_liked 按收藏量优先，不是点赞量。（可选值：most_commented / most_liked / most_viewed / newest / relevance）
- limit：这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 20）
- 返回一组记录，每条记录的主要字段：id、url、title、text、duration_seconds、duration_sec、duration_text（时长的展示文本（如 12:34））、view_count、like_count、comment_count、danmaku_count（弹幕数）、favorite_count（收藏数）；一共 21 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili。
- 示例请求体：
{
"platform": "bilibili",
"action": "search",
"params": {
"keyword": "摄影入门"
}
}
- 计费：$0.56 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。
写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。 |
platform | body | string | 是 | bilibili | 平台标识，固定值。 |
action | body | string | 是 | search | 能力标识，固定值。 |
keyword | body.params | string | 是 | - | B 站视频搜索词，可填视频标题或主题；不是 UP 主昵称精确查询。查询 UP 主资料或投稿请使用 user_id。 |
sort | body.params | string (enum) | 否 | - | 视频排序：relevance 综合、newest 最新、most_viewed 播放量、most_commented 评论相关、most_liked 按收藏量优先，不是点赞量。这组排序只作用于视频搜索，不决定 comments 的评论顺序。允许值most_commentedmost_likedmost_viewednewestrelevance |
limit | body.params | integer (1–50) | 否 | 20 | 这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
代码示例
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "bilibili",
"action": "search",
"params": {
"keyword": "摄影入门"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。
按视频主题搜索；详情、评论与弹幕需要视频目标。
响应示例
#2026年9月26日 16:56（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息，列表只保留前 2 条；id、billing、quota 每次调用都不同，只给结构。
json
{ "id": "req_…", "platform": "bilibili", "action": "search", "results": [ { "id": "BV1pv411H78e", "url": "https://www.bilibili.com/video/BV1pv411H78e", "title": "从零开始手把手教你学摄影，20节课带你从小白到大师 | 摄影前期拍摄入门教程", "text": "此课程是一套面向零基础小白的零基础摄影前期拍摄系统教程，分为4大部分，一共20节，由浅入深。课程从器材讲解到参数技巧，最后带领大家实战拍摄，可以快速带大家入门摄影，录制于2020年，因故未能发布，现在作为福利分享给大家~\r\n\r\nPS： 如果大家觉得有帮助的话，求个一键三连~\r\n\r\nPART1 知己知彼——认识你的器材\r\nPART2 基础入门——学懂枯燥的参数\r\nPART3 技能提升——拍摄技巧全解\r\nPART4 综合运用——带你复盘拍摄现场", "duration_seconds": 28849, "duration_text": "480:49", "view_count": 8307391, "like_count": 301661, "comment_count": 3799, "danmaku_count": 38430, "favorite_count": 752984, "thumbnail_url": "https://i1.hdslb.com/bfs/archive/d293a1682ffac131d109bd6180c4df644f632388.png", "posted_at": "2021-07-02T03:56:53+00:00", "category": "数码", "author_name": "•••", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "教程", "摄影", "相机" ] }, { "id": "BV1MceuzVEz7", "url": "https://www.bilibili.com/video/BV1MceuzVEz7", "title": "【吊打付费】目前B站最完整的摄影教程，包含了所有干货内容！这还没人看，我不更了！！！", "text": "一个冷知识：点赞是免费的！但是可以让辛苦做视频的UP主开心快乐一整天！！！\n 我给大家准备了摄影礼包，评论“666”即可得", "duration_seconds": 71221, "duration_text": "1187:1", "view_count": 2186277, "like_count": 50942, "comment_count": 12382, "danmaku_count": 6525, "favorite_count": 124107, "thumbnail_url": "https://i2.hdslb.com/bfs/archive/5fffaef73d60995cf40a9336b58fe68b15ca5033.jpg", "posted_at": "2025-08-20T09:20:00+00:00", "category": "数码", "author_name": "•••", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "摄影入门", "新手摄影", "零基础学摄影" ] } ], "count": 17, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
url | 该记录在原平台上的可访问链接。 |
title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
duration_sec | 保留平台原语义 |
duration_text | 时长的展示文本（如 12:34）。 |
view_count | 浏览/播放数。null 表示不公开，不等于 0。 |
like_count | 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。 |
comment_count | 评论数。null 表示不公开，不等于 0。 |
danmaku_count | 弹幕数。B站特有的互动指标，与评论数并列看活跃度。 |
favorite_count | 收藏数。 |
coin_count | 投币数。B站的付费级好评，比点赞含金量高。 |
share_count | 分享/转发数。null 表示不公开，不等于 0。 |
thumbnail_url | 缩略图链接，分辨率低于 image_url。 |
posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
author_name | 作者昵称（显示名）。 |
author_id | 作者在原平台的唯一 ID。 |
author_url | 作者在原平台的主页链接。 |
platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
tags | 标签数组。无标签时为空数组，不是 null。 |
常见问题
#错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足，先充值。
- 422
- 参数名或取值不对，按错误信息给的候选改；不扣费。
- 429
- 超过每分钟请求上限，按 Retry-After 等待后再试。
- 503
- 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
- 200 空结果
- 没有数据，不扣费。