{ "openapi": "3.0.1", "info": { "title": "Open Library Scraper — Books, Authors & Subjects", "description": "Scrape Open Library by search query, subject, or author. Extract title, ISBN, ratings, cover, publisher, subjects, and edition count for research, cataloging, and book discovery. No API key, no login.", "version": "1.0", "x-build-id": "MKHP34U3rUewVdEaO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~openlibrary-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-openlibrary-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/logiover~openlibrary-scraper/runs": { "post": { "operationId": "runs-sync-logiover-openlibrary-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/logiover~openlibrary-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-openlibrary-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": [ "trending", "search", "subject", "author", "bookDetail" ], "type": "string", "description": "What to scrape. 'trending' and an empty 'search' return popular books (great for a quick zero-config run). 'search' = full-text search; 'subject' = browse a genre; 'author' = search authors; 'bookDetail' = fetch specific work IDs.", "default": "trending" }, "query": { "title": "Search Query", "type": "string", "description": "Free-text search query for books or authors (used in 'search' and 'author' modes). Leave empty to browse popular books." }, "title": { "title": "Title Filter", "type": "string", "description": "Filter search results by title keyword (used in 'search' mode alongside query)." }, "author": { "title": "Author Filter", "type": "string", "description": "Filter search results by author name (used in 'search' mode)." }, "subject": { "title": "Subject / Genre", "enum": [ "fiction", "fantasy", "science_fiction", "mystery", "thriller", "romance", "horror", "historical_fiction", "biography", "history", "science", "mathematics", "philosophy", "psychology", "religion", "poetry", "drama", "children", "young_adult", "cookbooks", "art", "music", "travel", "business", "economics", "computers", "programming", "self-help", "health", "sports", "nature", "politics", "war", "adventure" ], "type": "string", "description": "Subject/genre to browse (used in 'subject' mode). Pick a common one or type your own slug (e.g. 'graphic_novels')." }, "sort": { "title": "Sort Order (search mode)", "enum": [ "", "rating", "readinglog", "already_read", "want_to_read", "editions", "old", "new", "random" ], "type": "string", "description": "Sort order for 'search' mode results.", "default": "" }, "trendingPeriod": { "title": "Trending Period", "enum": [ "now", "daily", "weekly", "monthly", "yearly" ], "type": "string", "description": "Time window for 'trending' mode (and the zero-input default browse).", "default": "daily" }, "workIds": { "title": "Work IDs", "type": "array", "description": "List of Open Library work IDs for book detail mode (e.g. 'OL45804W', '/works/OL45804W').", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of results to return (default 200, max 5000). Raise it to pull more.", "default": 200 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings (AUTO recommended). Open Library is a public API; the actor also falls back to a direct connection on the final retry." } } }, "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 } } } } } } } } } }