{ "openapi": "3.0.1", "info": { "title": "Douban Books & Music Scraper: 豆瓣 ISBN, Ratings & Top 250", "description": "Scrape Douban (豆瓣) books and music: title, author, publisher, ISBN, pages, price, rating, vote count, 5-star breakdown, reader counts, summary and author bio. Top 250, up to 1,000 titles per tag, charts and new releases. Movie Top 250 too. No login.", "version": "0.0", "x-build-id": "GuMrni8dl1fqZFpRO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/forgedata~douban-books-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-forgedata-douban-books-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/forgedata~douban-books-scraper/runs": { "post": { "operationId": "runs-sync-forgedata-douban-books-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/forgedata~douban-books-scraper/run-sync": { "post": { "operationId": "run-sync-forgedata-douban-books-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": { "category": { "title": "Category", "enum": [ "books", "music", "movies" ], "type": "string", "description": "Books and music get full detail pages. Movies are limited to Top 250 and the movie chart (list data only), because Douban protects movie pages with a security check.", "default": "books" }, "source": { "title": "What to collect", "enum": [ "top250", "tags", "chart", "latest", "urls" ], "type": "string", "description": "Top 250 is Douban's all-time ranked list. Tags lets you pull up to 1,000 titles per tag (e.g. 小说, 历史, 科幻, 摇滚). Chart and new releases are Douban's current lists. Or paste specific Douban subject URLs.", "default": "top250" }, "tags": { "title": "Tags", "type": "array", "description": "Used when 'By tag' is selected. Douban tags are Chinese, for example 小说 (fiction), 历史 (history), 科幻 (sci-fi), 经济学 (economics), 摇滚 (rock), 民谣 (folk). Each tag returns up to 1,000 titles.", "default": [ "小说" ], "items": { "type": "string" } }, "tagSort": { "title": "Tag sort order", "enum": [ "T", "R", "S" ], "type": "string", "description": "How Douban orders a tag's list.", "default": "T" }, "subjectUrls": { "title": "Subject URLs", "type": "array", "description": "Used when 'Only the URLs I paste' is selected. Example: https://book.douban.com/subject/1084336/", "default": [], "items": { "type": "string" } }, "includeDetails": { "title": "Open each title's page for full details", "type": "boolean", "description": "Adds ISBN, pages, binding, translator, series, the 5-star rating breakdown, reading counts, full summary and author bio. Turn off for faster list-only data. Movies are always list-only.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Stop after saving this many titles. You pay only for titles saved.", "default": 50 }, "minRating": { "title": "Minimum Douban rating", "minimum": 0, "maximum": 10, "type": "number", "description": "Keep only titles rated at least this (0 to 10). 0 keeps all.", "default": 0 }, "minVotes": { "title": "Minimum number of ratings", "minimum": 0, "type": "integer", "description": "Keep only titles rated by at least this many people. 0 keeps all.", "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 } } } } } } } } } }