{ "openapi": "3.0.1", "info": { "title": "Book & Product Metadata Scraper Pro: Amazon, GBooks, OpenLib", "description": "Scrape complete book data from Amazon, Google Books, Open Library and WorldCat. Accepts ISBN, ASIN, Amazon URL or keyword. Returns price, rating, reviews, description, cover image and all metadata. Exports CSV and Excel", "version": "0.0", "x-build-id": "BHuxRpAPJM5ioaxgl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapepilot~google-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapepilot-google-search-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/scrapepilot~google-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapepilot-google-search-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/scrapepilot~google-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapepilot-google-search-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": { "book_inputs": { "title": "šŸ“– Books to Scrape", "type": "string", "description": "Enter books to scrape ā€” one per line. Mix any format:\n\nšŸ“Œ ISBN-13 (most accurate):\n9780735224292\n9780062316097\n\nšŸ”— Amazon URL:\nhttps://www.amazon.com/dp/B08H93ZRLL\n\nšŸ”‘ ASIN:\nB08H93ZRLL\n0735224293\n\nšŸ” Keyword search:\nAtomic Habits James Clear\nHarry Potter\n\nāœļø Author search (prefix):\nauthor:Stephen King\nauthor:Yuval Noah Harari\n\nšŸ“š Title search (prefix):\ntitle:The Great Gatsby\ntitle:1984 George Orwell\n\nšŸ’” Tip: mix ISBNs, URLs and keywords ā€” all formats work." }, "max_items": { "title": "šŸ”¢ Max Books per Input", "minimum": 1, "maximum": 40, "type": "integer", "description": "Maximum number of books to return for each keyword/search input.\n\nšŸ“Œ Tip: For ISBN or ASIN inputs, this is always 1 (exact match).", "default": 10 }, "use_amazon": { "title": "šŸ›’ Scrape Amazon", "type": "boolean", "description": "ON ā†’ scrape Amazon for price, rating, reviews, description.\n\nāœ… Best for: price, star ratings, review count, buy links\nāš ļø Requires RESIDENTIAL proxy for best results.", "default": true }, "use_google_books": { "title": "šŸ“— Use Google Books API", "type": "boolean", "description": "ON ā†’ fetch from Google Books (free API, very fast, rich metadata).\n\nāœ… Best for: title, author, publisher, description, cover image, ISBN\nšŸš€ No proxy needed, always works.", "default": true }, "use_openlibrary": { "title": "šŸ“˜ Use Open Library", "type": "boolean", "description": "ON ā†’ fetch from Open Library (20M+ books, free, very reliable).\n\nāœ… Best for: ISBN lookup, older books, cover images\nšŸš€ No proxy needed, always works.", "default": true }, "use_worldcat": { "title": "šŸ“™ Use WorldCat", "type": "boolean", "description": "ON ā†’ also search WorldCat library catalog.\n\nāœ… Best for: rare books, academic books, library catalog data.\nāš ļø Slower ā€” enable only if needed.", "default": false }, "export_csv": { "title": "šŸ“Š Export CSV", "type": "boolean", "description": "Save results as a CSV file (results.csv) in the Key-Value Store.", "default": true }, "export_xlsx": { "title": "šŸ“Š Export Excel (XLSX)", "type": "boolean", "description": "Save results as an Excel file (results.xlsx) in the Key-Value Store.", "default": true }, "proxyConfiguration": { "title": "šŸ”’ Proxy (RESIDENTIAL for Amazon)", "type": "object", "description": "RESIDENTIAL proxy is required for Amazon scraping.\n\nāœ… Always keep RESIDENTIAL enabled for:\nā€¢ Amazon price and rating data\nā€¢ Avoiding Amazon CAPTCHA blocks\n\nāš ļø Google Books and Open Library work without proxy." } } }, "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 } } } } } } } } } }