{ "openapi": "3.0.1", "info": { "title": "Bilibili Scraper: Videos, Comments, Danmaku & Creators", "description": "Search Bilibili videos by keyword and get views, likes, coins, favorites, shares, danmaku, tags and author followers. Also comments, danmaku (bullet comments), creator profiles and trending lists. No login. Clean Excel rows.", "version": "1.0", "x-build-id": "6OPJJDp250HSEirj5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serenido~bilibili-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serenido-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/serenido~bilibili-scraper/runs": { "post": { "operationId": "runs-sync-serenido-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/serenido~bilibili-scraper/run-sync": { "post": { "operationId": "run-sync-serenido-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", "required": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "search", "videos", "comments", "danmaku", "creators", "trending" ], "type": "string", "description": "Pick one per run. No login or cookie needed in any mode.", "default": "search" }, "keywords": { "title": "Keywords", "type": "array", "description": "Search mode. One keyword per line, in Chinese or English. Each keyword is searched separately.", "items": { "type": "string" } }, "sort": { "title": "Sort by", "enum": [ "relevance", "views", "newest", "danmaku", "favorites", "comments" ], "type": "string", "description": "Same sort options as Bilibili's own search.", "default": "relevance" }, "duration": { "title": "Video length", "enum": [ "any", "under_10", "10_30", "30_60", "over_60" ], "type": "string", "description": "Bilibili's own duration filter.", "default": "any" }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Optional. Only videos published on or after this date (YYYY-MM-DD, UTC)." }, "publishedBefore": { "title": "Published before", "type": "string", "description": "Optional. Only videos published on or before this date (YYYY-MM-DD, UTC, the whole day is included)." }, "maxResults": { "title": "Max videos per keyword (or per trending list)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Bilibili shows about 1,000 videos per search. Above 1,000 the scraper searches again in date windows to find more, up to 5,000.", "default": 20 }, "videoUrls": { "title": "Video URLs or BV ids", "type": "array", "description": "For Video details, Comments and Danmaku. Accepts bilibili.com/video/BV... links, BV ids, av ids and b23.tv short links. Add ?p=2 to a link for one part of a multi-part video.", "items": { "type": "string" } }, "includeDetails": { "title": "Add full stats to every video", "type": "boolean", "description": "Search and Trending modes: one extra request per video adds coins, shares, exact likes, tags and the author's follower count. Same price per row.", "default": true }, "includeComments": { "title": "Also get comments of every video", "type": "boolean", "description": "Search, Video details and Trending modes: adds comment rows (type: comment) for each video. Every comment is one billed row.", "default": false }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Bilibili shows logged-out visitors the top comments of a video. You get those plus their full reply threads, up to this number.", "default": 20 }, "maxDanmakuPerVideo": { "title": "Max danmaku per video", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Danmaku mode. Each danmaku (bullet comment) is one row with its exact second on the video.", "default": 1000 }, "creatorIds": { "title": "Creator ids or links", "type": "array", "description": "Creator profiles mode. The number in space.bilibili.com/NUMBER, or the full link.", "items": { "type": "string" } }, "trendingList": { "title": "Trending list", "enum": [ "popular", "ranking", "hot_searches" ], "type": "string", "description": "Trending mode.", "default": "popular" }, "category": { "title": "Ranking category", "enum": [ "all", "animation", "music", "dance", "game", "knowledge", "tech", "sports", "car", "life", "food", "animals", "kichiku", "fashion", "entertainment", "film", "guochuang" ], "type": "string", "description": "For the Top 100 ranking.", "default": "all" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests run at the same time. 5 is fast and gentle.", "default": 5 }, "proxy": { "title": "Proxy (optional)", "type": "object", "description": "Not needed: the scraper connects directly and switches to Apify proxies by itself if Bilibili slows it down. Set one only if you want every request to use it." } } }, "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 } } } } } } } } } }