{ "openapi": "3.0.1", "info": { "title": "Bilibili Scraper | 哔哩哔哩 B站 Video Search: Views, Likes, Replies", "description": "Scrape Bilibili (China's dominant video platform) by keyword, video URL or creator ID: views, danmaku, likes, coins, favorites, shares, duration and creator stats. Public API, no login, no browser needed.", "version": "0.1", "x-build-id": "YIx1JwPK02aIOS27x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~bilibili-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-bilibili-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/themineworks~bilibili-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-bilibili-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/themineworks~bilibili-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-bilibili-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "Video keywords to search on Bilibili, e.g. \"美食\" or an English term. Each keyword returns a page of ranked video results with full stats.", "items": { "type": "string" } }, "maxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many videos to return per keyword search. About 20 per page, so this also controls how many search pages are fetched.", "default": 20 }, "videoUrls": { "title": "Video URLs or BV IDs", "type": "array", "description": "Direct Bilibili video links (e.g. https://www.bilibili.com/video/BV1xx411c7mD) or bare BV IDs. Returns full video detail: view/danmaku/reply/favorite/coin/share/like counts, duration, parts and creator.", "items": { "type": "string" } }, "creatorIds": { "title": "Creator (UP主) UIDs", "type": "array", "description": "Numeric Bilibili user IDs, for example 546195, the number in a creator's space URL like space.bilibili.com/546195. Returns the creator's public profile: name, fans, follows, level, verification and bio.", "items": { "type": "string" } }, "danmakuVideoUrls": { "title": "Danmaku (弹幕): video URLs, BV IDs or av numbers", "type": "array", "description": "Videos whose bullet comments you want, one row per danmaku with its exact second in the video, text, color, display mode, send time and sender hash. Returns the video's current public display pool (often 1,000 to 8,000 per part). Multi-part videos include every part. Free until 15 Oct 2026 (up to 20,000 per run), then $1.00 per 1,000 danmaku.", "items": { "type": "string" } }, "maxDanmakuPerVideo": { "title": "Max danmaku per video", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Cap per video. When capped, the highest-weight danmaku are kept and returned in timeline order. 0 returns the whole pool.", "default": 1000 }, "danmakuStartSec": { "title": "Danmaku window start (seconds)", "minimum": 0, "type": "integer", "description": "Only danmaku at or after this second of the video.", "default": 0 }, "danmakuEndSec": { "title": "Danmaku window end (seconds)", "minimum": 0, "type": "integer", "description": "Only danmaku at or before this second of the video. 0 means the end of the video.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }