{ "openapi": "3.0.1", "info": { "title": "Google Play Audiobooks - Full Detail & Reviews", "description": "[$1.5/1000] Crawl every Google Play Audiobooks genre, then get full detail per audiobook: description, author bio, narrator, publisher, ISBN, duration, price, rating breakdown, real reviews with author and text, genres and related titles.", "version": "0.1", "x-build-id": "IC6WrSvrd7l4qGG5H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ryyos~google-play-audiobooks-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ryyos-google-play-audiobooks-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/ryyos~google-play-audiobooks-scraper/runs": { "post": { "operationId": "runs-sync-ryyos-google-play-audiobooks-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/ryyos~google-play-audiobooks-scraper/run-sync": { "post": { "operationId": "run-sync-ryyos-google-play-audiobooks-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": { "genres": { "title": "Sources to crawl", "type": "array", "description": "Which Google Play Audiobooks source pages to browse. Google Play currently only server-renders real listing content for the general 'All audiobooks' tab and the 'Children's audiobooks' genre - the other genre-filter pages linked from Google's own navigation return an empty page (client-side rendering Google has not enabled for those routes at the time of writing). The 'All audiobooks' tab is not genre-limited, so leaving this empty already gives broad cross-category coverage. Leave empty to crawl both working sources.", "items": { "type": "string", "enum": [ "audiobooks", "audiobooks_coll_1689" ], "enumTitles": [ "All audiobooks", "Children's audiobooks" ] } }, "country": { "title": "Country (gl)", "type": "string", "description": "Two-letter Google Play storefront country code, e.g. 'us', 'gb', 'id', 'jp'. Affects pricing, availability and which audiobooks are shown.", "default": "us" }, "language": { "title": "Language (hl)", "type": "string", "description": "Language code for the scraped UI/text, e.g. 'en', 'id', 'ja'.", "default": "en" }, "maxAudiobooksPerSource": { "title": "Max audiobooks per genre", "minimum": 0, "type": "integer", "description": "Upper bound on how many audiobooks to take from each individual genre page. Set to 0 to take every audiobook Google Play server-renders on that listing page (typically ~100-150). The same audiobook found under multiple genres is only detail-scraped once.", "default": 60 }, "maxReviewsPerAudiobook": { "title": "Max reviews per audiobook", "minimum": 0, "type": "integer", "description": "Upper bound on how many individual reviews (author, rating, text, date) to keep per audiobook, taken from the featured reviews Google Play itself renders on the audiobook page (typically up to 3). Set to 0 to skip review extraction entirely.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "play.google.com did not require proxies during testing (no CAPTCHA/anti-bot challenge on listing or detail pages), but Apify Proxy is recommended for large runs to keep your IP healthy given the request volume of scraping many audiobook detail pages.", "default": { "useApifyProxy": 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 } } } } } } } } } }