{ "openapi": "3.0.1", "info": { "title": "Bilibili Creator Scraper", "description": "Find bilibili (B站) creators by keyword or UID, or scrape the trending video leaderboard by category. Get followers, level, official verification, live stream status, recent video engagement (views, coins, danmaku, favorites), and trending rankings.", "version": "0.1", "x-build-id": "IAdx17ufBIXhzPuDK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~bilibili-creator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-bilibili-creator-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/jungle_synthesizer~bilibili-creator-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-bilibili-creator-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/jungle_synthesizer~bilibili-creator-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-bilibili-creator-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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Mode", "enum": [ "profile", "rankings" ], "type": "string", "description": "'profile' (default): search/lookup individual creators. 'rankings': scrape the bilibili trending video leaderboard per category (folded in from the decommissioned bilibili-creator-leaderboard-scraper).", "default": "profile" }, "searchTerms": { "title": "Search Keywords", "type": "array", "description": "Keywords to search bilibili for matching creators (e.g. 'cooking', 'anime'). One paginated query per keyword. Leave empty to look up explicit UIDs only. Ignored in rankings mode.", "items": { "type": "string" }, "default": [] }, "startUids": { "title": "Direct Creator UIDs", "type": "array", "description": "Optional. List of bilibili UIDs (e.g. 2, 1850091) to look up directly via the card endpoint. Use this when you already know the creator IDs and want to skip search. Ignored in rankings mode.", "items": { "type": "string" }, "default": [] }, "searchOrder": { "title": "Search Order", "enum": [ "fans", "totalrank", "pubdate", "click" ], "type": "string", "description": "How to rank search results when using Search Keywords. Ignored in rankings mode.", "default": "fans" }, "enrich_video_stats": { "title": "Enrich Video Stats", "type": "boolean", "description": "When enabled, each creator's recent videos are enriched via the per-video endpoint to add full like / coin / favorite counts plus partition and tags. Adds ~3 extra API calls per creator. Ignored in rankings mode.", "default": false }, "categories": { "title": "Categories (rankings mode)", "type": "array", "description": "Rankings mode only. List of Bilibili category IDs (tids) to scrape. Use 0 for \"All\" (default), or specific tids: 1=Animation, 3=Music, 4=Gaming, 17=Entertainment, 36=Knowledge, 95=Digital, 119=Lifestyle, 129=Fashion, 174=Sports, 176=Film, 181=TV Series, 188=Documentary.", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to return. In profile mode, this caps creators; in rankings mode, it caps trending video records across all selected categories. Default is conservative to fit within Apify's automated test window.", "default": 15 } } }, "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 } } }, "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 } } } } } } } } } }