{ "openapi": "3.0.1", "info": { "title": "Literal.club Books & Reviews Scraper", "description": "Extract public Literal club book metadata, visible reviews, authors, ratings, and profiles, then output structured book, review, author, and profile rows for catalog enrichment and analysis. Start from book names, ISBNs, URLs, authors, or profile handles. No API or login.", "version": "0.3", "x-build-id": "LdFC0DvdeQPQI1NW5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~literal-club-book-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-literal-club-book-reviews-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/thescrapelab~literal-club-book-reviews-scraper/runs": { "post": { "operationId": "runs-sync-thescrapelab-literal-club-book-reviews-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/thescrapelab~literal-club-book-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-thescrapelab-literal-club-book-reviews-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": { "searchQueries": { "title": "Book names", "type": "array", "description": "Book titles or search terms to look up on public Literal.club pages. Start here for the simplest run.", "items": { "type": "string" } }, "isbns": { "title": "ISBNs", "type": "array", "description": "Optional ISBN-10 or ISBN-13 values. Spaces and hyphens are removed automatically.", "items": { "type": "string" } }, "authorNames": { "title": "Author names", "type": "array", "description": "Optional author names to search for related public Literal.club book pages.", "items": { "type": "string" } }, "startUrls": { "title": "Literal URLs", "type": "array", "description": "Optional public Literal.club book, search, author, profile, or profile review URLs. Direct book URLs are fastest and most precise.", "items": { "type": "string" } }, "profileHandles": { "title": "Profile handles", "type": "array", "description": "Optional public Literal.club profile handles. When reviews are enabled, the Actor scrapes that user's public reviews page.", "items": { "type": "string" } }, "includeReviews": { "title": "Scrape reviews", "type": "boolean", "description": "Collect public review text rendered on book pages and profile review pages.", "default": false }, "maxReviews": { "title": "Maximum reviews", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of review records to save for the whole run. This is a cap, not a guarantee that reviews exist publicly.", "default": 20 }, "maxBooks": { "title": "Maximum books", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum book pages to enrich during the run. Lower values keep runs cheaper and more predictable.", "default": 10 }, "maxSearchResultsPerQuery": { "title": "Books per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum Literal.club book links to follow for each book name, author name, or ISBN search.", "default": 2 }, "enableIsbnDiscovery": { "title": "Use extra ISBN discovery", "type": "boolean", "description": "Uses public book metadata pages to improve ISBN and author-name matching. Turn it off for direct Literal URLs when you want the cheapest precise run.", "default": true } } }, "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 } } } } } } } } } }