{ "openapi": "3.0.1", "info": { "title": "Project Gutenberg Scraper", "description": "Search and download Project Gutenberg's 75,000+ free ebooks. Filter by keyword, topic, language, author era, copyright status, and available format (EPUB, Kindle, PDF, plain text).", "version": "1.0", "x-build-id": "ldr9ANkrLR04cGHBT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~project-gutenberg-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-project-gutenberg-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/crawlerbros~project-gutenberg-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-project-gutenberg-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/crawlerbros~project-gutenberg-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-project-gutenberg-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": "Mode", "enum": [ "search", "byIds" ], "type": "string", "description": "`search` finds books by keyword/filters. `byIds` fetches specific books by their Project Gutenberg ID numbers.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Search book titles and author names, e.g. a title word, phrase, or author's name.", "default": "shakespeare" }, "topic": { "title": "Topic / subject", "type": "string", "description": "Case-insensitive key phrase to search in a book's bookshelves or subjects, e.g. `children`, `science fiction`, `poetry`." }, "languages": { "title": "Languages", "type": "array", "description": "Filter to books in one or more of these languages. Leave empty for all languages.", "items": { "type": "string", "enum": [ "en", "fr", "fi", "de", "nl", "it", "es", "hu", "pt", "zh", "sv", "el", "la", "eo", "ca", "da", "tl", "pl", "no", "ja", "fy", "af", "cy", "cs", "ru", "he", "is", "enm", "ro", "ga", "sl", "sr", "ang", "gl", "grc", "myn", "nah", "ceb", "oc", "ar", "br", "yi", "ko", "fa", "sa", "iu", "oji", "lt", "et", "kha" ], "enumTitles": [ "English", "French", "Finnish", "German", "Dutch", "Italian", "Spanish", "Hungarian", "Portuguese", "Chinese", "Swedish", "Greek (Modern)", "Latin", "Esperanto", "Catalan", "Danish", "Tagalog", "Polish", "Norwegian", "Japanese", "Frisian", "Afrikaans", "Welsh", "Czech", "Russian", "Hebrew", "Icelandic", "Middle English", "Romanian", "Irish", "Slovenian", "Serbian", "Old English", "Galician", "Greek (Ancient)", "Mayan languages", "Nahuatl", "Cebuano", "Occitan", "Arabic", "Breton", "Yiddish", "Korean", "Persian", "Sanskrit", "Inuktitut", "Ojibwa", "Lithuanian", "Estonian", "Khasi" ] }, "default": [] }, "copyrightStatus": { "title": "Copyright status", "enum": [ "any", "publicDomain", "copyrighted", "unknown" ], "type": "string", "description": "Filter by copyright status as recorded by Project Gutenberg.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "popular", "ascending", "descending" ], "type": "string", "description": "`popular` sorts by number of downloads (default). `ascending`/`descending` sort by Project Gutenberg ID number.", "default": "popular" }, "authorYearFrom": { "title": "Author alive from year", "minimum": -3000, "maximum": 2026, "type": "integer", "description": "Only include books with at least one author alive on or after this year. Use negative numbers for BCE (e.g. -499 for 500 BCE)." }, "authorYearTo": { "title": "Author alive to year", "minimum": -3000, "maximum": 2026, "type": "integer", "description": "Only include books with at least one author alive on or before this year. Use negative numbers for BCE." }, "mimeType": { "title": "Available format", "enum": [ "any", "text/html", "application/epub+zip", "application/x-mobipocket-ebook", "application/pdf", "text/plain", "image/jpeg", "application/rdf+xml" ], "type": "string", "description": "Only include books that are available in this file format.", "default": "any" }, "gutenbergIds": { "title": "Gutenberg IDs", "type": "array", "description": "Project Gutenberg ID numbers to fetch directly. Required when Mode is `byIds`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } }