{ "openapi": "3.0.1", "info": { "title": "Bilibili Scraper — Video Search & Video Details (No Login)", "description": "Search Bilibili videos by keyword (up to 1,000 per keyword) or fetch full metadata for BV ids and video URLs. Plain HTTP first, browser fallback, documented output schema, no login. Pay per result.", "version": "1.0", "x-build-id": "p3lx7h67tM1w37zkB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cemented_jest~bilibili-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cemented_jest-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/cemented_jest~bilibili-scraper/runs": { "post": { "operationId": "runs-sync-cemented_jest-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/cemented_jest~bilibili-scraper/run-sync": { "post": { "operationId": "run-sync-cemented_jest-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": { "mode": { "title": "Mode", "enum": [ "search", "video" ], "type": "string", "description": "`search`: keywords in, matching videos out (event `video-result`). `video`: BV ids / av ids / video URLs in, full video metadata out, including coin and share counts (event `video-detail`).", "default": "search" }, "keywords": { "title": "Keywords (search mode)", "maxItems": 50, "type": "array", "description": "Search phrases, 1 to 50, used when Mode is `search`. Chinese keywords return the best results. Each keyword is searched separately; `maxItems` applies per keyword.", "default": [], "items": { "type": "string" } }, "order": { "title": "Sort order (search mode)", "enum": [ "relevance", "pubdate", "click", "dm", "stow" ], "type": "string", "description": "`relevance` is the default ranking (no sort parameter). `pubdate` = newest first, `click` = most played, `dm` = most danmaku and `stow` = most favorited: each was checked with real requests on 2026-11-04 (one keyword, 42-50 results, no order violation).", "default": "relevance" }, "maxItems": { "title": "Max items per keyword (search mode)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many videos to return for each keyword, 1 to 1,000. Bilibili serves at most about 1,000 results per keyword and the list overlaps between pages, so a broad keyword typically yields fewer than 1,000 unique videos; see `windowLimited` in the RUN_SUMMARY record.", "default": 100 }, "videoUrls": { "title": "Videos (video mode)", "maxItems": 1000, "type": "array", "description": "BV ids (`BV1c4411e77t`), av ids (`av52080698`) or video URLs (`https://www.bilibili.com/video/BV1c4411e77t`), 1 to 1,000, used when Mode is `video`. Duplicates (the same video given twice, for example as BV and av) are returned and charged once.", "default": [], "items": { "type": "string" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Keywords or videos processed in parallel, 1 to 10. Requests are also spaced out; raising this does not make single keywords faster.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for all requests. Default: Apify residential proxy with a US exit, the configuration that was tested for both modes. Datacenter proxies are refused by Bilibili video pages (HTTP 412), so video mode needs residential IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "debug": { "title": "Debug", "type": "boolean", "description": "Verbose logging, and the body of every response that could not be parsed is saved to the key-value store (DEBUG_* records).", "default": false } } }, "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 } } } } } } } } } }