{ "openapi": "3.0.1", "info": { "title": "Bilibili Comments Scraper: Hot Comments & Reply Threads", "description": "Bilibili Comments Scraper collects public hot or newest video comments and reply threads by video URL or keyword. Export text, authors, likes, timestamps, thread linkage, and optional video details for audience research.", "version": "0.1", "x-build-id": "9CLqK9Zp0eWDWif3b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xmolodtsov~bilibili-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xmolodtsov-bilibili-comments-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/xmolodtsov~bilibili-comments-scraper/runs": { "post": { "operationId": "runs-sync-xmolodtsov-bilibili-comments-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/xmolodtsov~bilibili-comments-scraper/run-sync": { "post": { "operationId": "run-sync-xmolodtsov-bilibili-comments-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": { "videoUrls": { "title": "Video URLs or IDs", "type": "array", "description": "Public video BV IDs, av IDs, Bilibili video URLs (including ?p=), or b23.tv links. Invalid entries are skipped.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search keywords", "maxItems": 100, "type": "array", "description": "Up to 100 keywords in Chinese or English. Videos shared across keywords are scraped once.", "items": { "type": "string" } }, "maxVideosPerKeyword": { "title": "Maximum videos per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Unique videos to select for each keyword; search stops at source exhaustion or 50 pages. Search coverage was tested on pages 1–2; deeper search is best effort.", "default": 10 }, "searchSort": { "title": "Search order", "enum": [ "totalrank", "click", "pubdate", "dm", "stow", "scores" ], "type": "string", "description": "Order used when finding public videos.", "default": "totalrank" }, "maxCommentsPerVideo": { "title": "Maximum comments and replies per video", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Combined comment and reply row limit per video. Tested to 1,200+ roots in bounded probes; source exhaustion may return fewer. Free Apify plan: up to 100 results per run and 20 runs per month (a limit set by the developer, not by Apify).", "default": 100 }, "commentSort": { "title": "Comment order", "enum": [ "hot", "newest" ], "type": "string", "description": "Hot comments or newest comments. Reply pages use Bilibili’s thread order.", "default": "hot" }, "includeReplies": { "title": "Include reply threads", "type": "boolean", "description": "Fetch replies to selected root comments. Each reply is one billed result and counts toward the per-video comment limit.", "default": true }, "maxRepliesPerComment": { "title": "Maximum replies per root comment", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Page through each selected root’s replies, up to this limit and the shared per-video comment limit.", "default": 20 }, "includeVideoDetails": { "title": "Include video rows", "type": "boolean", "description": "Add one video details row, including statistics and tags, for each available video with open comments. Each video row is one billed result.", "default": true }, "includeDanmaku": { "title": "Include experimental danmaku", "type": "boolean", "description": "Experimental: collect the available XML pool of timeline comments. Each danmaku row is one billed result; evenly sample the pool when larger than the per-video limit. This is not a complete historical archive.", "default": false }, "maxDanmakuPerVideo": { "title": "Maximum danmaku per video", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum XML rows per video, evenly spread across the available pool’s timeline. Separate from the comment/reply limit; shares the free run cap.", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter by default. Residential is optional. Free runs always use Apify Proxy; custom proxy URLs and direct access apply only to paid/local runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }