# Bilibili Search API (bilibili.search)

- Canonical page: https://everyinfra.com/en/bilibili-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "bilibili", "action": "search", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

Bilibili Search finds videos by `keyword` and returns each video's title, description, length, view, like, comment, danmaku, favorite, coin and share counts, plus its category, tags, uploader and publish time. Use it to see which videos exist on a topic and which do best, for topic research, tracking brand mentions or finding uploaders to work with.

Order results with `sort` (relevance, newest, most viewed or most commented); note that `most_liked` actually ranks by favorites, not likes. When judging popularity, give weight to `coin_count`: coins are a paid form of approval on Bilibili and count for more than likes, while `danmaku_count` sits next to comments as a measure of how actively people watch.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=bilibili&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies video search terms for Bilibili based on titles or topics, rather than an exact uploader nickname search. Use user_id to query uploader profiles or user submissions. |
| sort | enum: most_commented / most_liked / most_viewed / newest / relevance | no | not declared | Specifies the video sort order: relevance, newest for latest, most_viewed for view count, most_commented for comment relevance, and most_liked for favorites rather than likes. It applies to video search only and does not set the order of comments. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_sec | platform-native meaning |
| duration_text | Duration as displayed text (for example 12:34). |
| view_count | Views or plays. null means not disclosed, not 0. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| danmaku_count | Danmaku (on-screen comment) count. **A Bilibili-specific engagement signal; read it alongside comment_count.** |
| favorite_count | Favorites. |
| coin_count | Coins given. Coins are a paid form of approval on Bilibili and weigh more than likes. |
| share_count | Shares. null means not disclosed, not 0. |
| thumbnail_url | Thumbnail link, lower resolution than image_url. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_url | Link to the author's profile on the platform. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| tags | Array of tags. An empty array, not null, when there are none. |

## Example

```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": "摄影入门"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "bilibili",
        "action": "search",
        "params": {
            "keyword": "摄影入门",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 17. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

## FAQ

### Why doesn't `most_liked` sort by likes?

In the current mapping `most_liked` ranks videos by favorites, not by likes. To list the most-liked videos, fetch the results and sort them by `like_count` yourself.

### How do I judge how popular a video really is?

Look beyond `view_count` at `coin_count`, `favorite_count` and `danmaku_count`. Coins are a paid form of approval, while favorites and dense on-screen comments show how invested viewers are; read together, they say more than views alone.

### Can I search by uploader?

`keyword` matches video titles and topics, not uploader nicknames exactly. `author_id` in a result is the uploader's numeric ID; pass it to the Bilibili Details capability for the profile, or to Posts by user for their uploads.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md