{
  "data": {
    "id": "RHIMj9apggQcHMtDi",
    "actId": "hTiiWhMSJ0SEiOkAK",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-11-17T02:11:28.411Z",
    "finishedAt": "2026-11-17T02:11:31.492Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 2946,
      "runTimeSecs": 2.946,
      "computeUnits": 0.0032733333333333334,
      "imageSizeBytes": 319179264
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Google Books & Play Books Catalog Explorer Input\",\n  \"description\": \"Search Google Books by keyword, author, subject, ISBN or volume ID, search Play Books with live prices, or pull Google Ngram time series.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch. Each mode reads its own input block below.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byVolumeIds\",\n        \"byIsbn\",\n        \"byAuthor\",\n        \"bySubject\",\n        \"playStoreSearch\",\n        \"ngrams\"\n      ],\n      \"enumTitles\": [\n        \"Search the Google Books catalog\",\n        \"Look up volumes by ID or URL\",\n        \"Look up ISBNs\",\n        \"Books by author\",\n        \"Books by subject / category\",\n        \"Play Books store search with prices\",\n        \"Ngram word-frequency time series\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\",\n      \"sectionCaption\": \"What to fetch\",\n      \"sectionDescription\": \"Pick a catalog search, exact lookup, Play Books price search or Ngram time series.\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Search query\",\n      \"type\": \"string\",\n      \"description\": \"Keywords for mode=search or mode=playStoreSearch. Google Books operators work: `intitle:`, `inauthor:`, `inpublisher:`, `subject:`, `isbn:`, combinable with spaces/OR. Example: `intitle:dune inauthor:herbert`.\",\n      \"editor\": \"textfield\",\n      \"default\": \"the lord of the rings\",\n      \"prefill\": \"the lord of the rings\",\n      \"sectionCaption\": \"Search and lookup inputs\",\n      \"sectionDescription\": \"Fill only the block used by the selected mode.\"\n    },\n    \"volumeIds\": {\n      \"title\": \"Volume IDs or URLs (mode=byVolumeIds)\",\n      \"type\": \"array\",\n      \"description\": \"Google Books volume IDs (e.g. `zyTCAlFPjgYC`) or Books/Play URLs containing `id=`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"isbns\": {\n      \"title\": \"ISBNs (mode=byIsbn)\",\n      \"type\": \"array\",\n      \"description\": \"ISBN-10 or ISBN-13 values, with or without hyphens.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"authorNames\": {\n      \"title\": \"Author names (mode=byAuthor)\",\n      \"type\": \"array\",\n      \"description\": \"Author names to search with Google Books' `inauthor:` operator, e.g. `Frank Herbert`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"subjects\": {\n      \"title\": \"Subjects / categories (mode=bySubject)\",\n      \"type\": \"array\",\n      \"description\": \"BISAC-style subject names to search with `subject:`, e.g. `Science Fiction`, `Business & Economics`, `Juvenile Fiction`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"ngramPhrases\": {\n      \"title\": \"Phrases (mode=ngrams)\",\n      \"type\": \"array\",\n      \"description\": \"Words or phrases to compare, e.g. `dune`, `artificial intelligence`, `climate change`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"language\": {\n      \"title\": \"Language (book modes)\",\n      \"type\": \"string\",\n      \"description\": \"Keep books in one language. Applied to the fetched result window. Use `languageCode` for a code not listed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"en\",\n        \"es\",\n        \"fr\",\n        \"de\",\n        \"it\",\n        \"pt\",\n        \"nl\",\n        \"ru\",\n        \"ja\",\n        \"zh\",\n        \"ko\",\n        \"ar\",\n        \"he\",\n        \"hi\",\n        \"tr\",\n        \"pl\",\n        \"sv\",\n        \"da\",\n        \"fi\",\n        \"no\",\n        \"el\",\n        \"cs\",\n        \"hu\",\n        \"ro\",\n        \"uk\",\n        \"vi\",\n        \"th\",\n        \"id\",\n        \"ms\",\n        \"fa\",\n        \"sw\",\n        \"la\",\n        \"ca\",\n        \"hr\",\n        \"sk\",\n        \"sl\",\n        \"sr\",\n        \"bg\",\n        \"lt\",\n        \"lv\",\n        \"et\",\n        \"is\",\n        \"ga\",\n        \"cy\",\n        \"af\",\n        \"sq\",\n        \"mk\",\n        \"bs\",\n        \"ka\",\n        \"hy\",\n        \"az\",\n        \"kk\",\n        \"uz\",\n        \"bn\",\n        \"ta\",\n        \"te\",\n        \"ml\",\n        \"kn\",\n        \"mr\",\n        \"gu\",\n        \"pa\",\n        \"ur\",\n        \"ne\",\n        \"si\",\n        \"km\",\n        \"lo\",\n        \"my\",\n        \"mn\",\n        \"bo\",\n        \"eu\",\n        \"gl\",\n        \"mt\",\n        \"lb\",\n        \"eo\"\n      ],\n      \"enumTitles\": [\n        \"Any language\",\n        \"EN\",\n        \"ES\",\n        \"FR\",\n        \"DE\",\n        \"IT\",\n        \"PT\",\n        \"NL\",\n        \"RU\",\n        \"JA\",\n        \"ZH\",\n        \"KO\",\n        \"AR\",\n        \"HE\",\n        \"HI\",\n        \"TR\",\n        \"PL\",\n        \"SV\",\n        \"DA\",\n        \"FI\",\n        \"NO\",\n        \"EL\",\n        \"CS\",\n        \"HU\",\n        \"RO\",\n        \"UK\",\n        \"VI\",\n        \"TH\",\n        \"ID\",\n        \"MS\",\n        \"FA\",\n        \"SW\",\n        \"LA\",\n        \"CA\",\n        \"HR\",\n        \"SK\",\n        \"SL\",\n        \"SR\",\n        \"BG\",\n        \"LT\",\n        \"LV\",\n        \"ET\",\n        \"IS\",\n        \"GA\",\n        \"CY\",\n        \"AF\",\n        \"SQ\",\n        \"MK\",\n        \"BS\",\n        \"KA\",\n        \"HY\",\n        \"AZ\",\n        \"KK\",\n        \"UZ\",\n        \"BN\",\n        \"TA\",\n        \"TE\",\n        \"ML\",\n        \"KN\",\n        \"MR\",\n        \"GU\",\n        \"PA\",\n        \"UR\",\n        \"NE\",\n        \"SI\",\n        \"KM\",\n        \"LO\",\n        \"MY\",\n        \"MN\",\n        \"BO\",\n        \"EU\",\n        \"GL\",\n        \"MT\",\n        \"LB\",\n        \"EO\"\n      ],\n      \"default\": \"any\",\n      \"prefill\": \"any\",\n      \"sectionCaption\": \"Book filters\",\n      \"sectionDescription\": \"Client-side filters applied to search, author, subject and ISBN result sets.\"\n    },\n    \"languageCode\": {\n      \"title\": \"Language code override (book modes)\",\n      \"type\": \"string\",\n      \"description\": \"Optional exact ISO 639-1/639-2 code (e.g. `eo`, `tl`). Takes precedence over the Language dropdown.\",\n      \"editor\": \"textfield\"\n    },\n    \"viewability\": {\n      \"title\": \"Viewability (book modes)\",\n      \"type\": \"string\",\n      \"description\": \"Filter by how much of the book Google shows: full view, preview or no preview.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"full\",\n        \"preview\",\n        \"none\"\n      ],\n      \"enumTitles\": [\n        \"Any viewability\",\n        \"Full view\",\n        \"Preview only\",\n        \"No preview\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"printType\": {\n      \"title\": \"Print type (book modes)\",\n      \"type\": \"string\",\n      \"description\": \"Restrict results to books or magazines.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"books\",\n        \"magazines\"\n      ],\n      \"enumTitles\": [\n        \"Books and magazines\",\n        \"Books only\",\n        \"Magazines only\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"freeEbooksOnly\": {\n      \"title\": \"Free ebooks only (book modes)\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only open-access volumes (public-domain or free full-view books).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order (book modes)\",\n      \"type\": \"string\",\n      \"description\": \"Relevance keeps Google's order. Newest sorts the fetched result window by publication date, newest first.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"newest\"\n      ],\n      \"enumTitles\": [\n        \"Relevance\",\n        \"Newest first\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"ngramYearStart\": {\n      \"title\": \"Start year (mode=ngrams)\",\n      \"type\": \"integer\",\n      \"description\": \"First year of the Ngram time series (1800–2022).\",\n      \"minimum\": 1800,\n      \"maximum\": 2022,\n      \"default\": 1800,\n      \"prefill\": 1800,\n      \"sectionCaption\": \"Ngram options\",\n      \"sectionDescription\": \"Only used when mode=ngrams.\"\n    },\n    \"ngramYearEnd\": {\n      \"title\": \"End year (mode=ngrams)\",\n      \"type\": \"integer\",\n      \"description\": \"Last year of the Ngram time series (1800–2022). Must be at least the start year.\",\n      \"minimum\": 1800,\n      \"maximum\": 2022,\n      \"default\": 2019,\n      \"prefill\": 2019\n    },\n    \"ngramCorpus\": {\n      \"title\": \"Corpus (mode=ngrams)\",\n      \"type\": \"string\",\n      \"description\": \"Google Books Ngram corpus to query.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"en\",\n        \"en-US\",\n        \"en-GB\",\n        \"en-fiction\",\n        \"fr\",\n        \"de\",\n        \"es\",\n        \"it\",\n        \"ru\",\n        \"he\",\n        \"zh\"\n      ],\n      \"enumTitles\": [\n        \"English (all)\",\n        \"American English\",\n        \"British English\",\n        \"English fiction\",\n        \"French\",\n        \"German\",\n        \"Spanish\",\n        \"Italian\",\n        \"Russian\",\n        \"Hebrew\",\n        \"Chinese (simplified)\"\n      ],\n      \"default\": \"en\",\n      \"prefill\": \"en\"\n    },\n    \"ngramSmoothing\": {\n      \"title\": \"Smoothing (mode=ngrams)\",\n      \"type\": \"integer\",\n      \"description\": \"Smoothing window, 0 (none) to 50. Google's default is 3.\",\n      \"minimum\": 0,\n      \"maximum\": 50,\n      \"default\": 3,\n      \"prefill\": 3\n    },\n    \"ngramCaseInsensitive\": {\n      \"title\": \"Group case variants (mode=ngrams)\",\n      \"type\": \"boolean\",\n      \"description\": \"When on, emit a case-insensitive aggregate plus one row per case variant.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"includeFullDetails\": {\n      \"title\": \"Fetch full volume details\",\n      \"type\": \"boolean\",\n      \"description\": \"Book modes only. Fetch each volume's detail feed for the full description and finer BISAC categories. One extra small request per record; off in the daily prefill.\",\n      \"default\": true,\n      \"prefill\": false,\n      \"sectionCaption\": \"Output and enrichment\",\n      \"sectionDescription\": \"Control enrichment requests and the record cap.\"\n    },\n    \"includePlayStoreDetails\": {\n      \"title\": \"Fetch Play Books price & rating\",\n      \"type\": \"boolean\",\n      \"description\": \"Book modes only. Check each volume's Play Books page and add price, currency, rating and the verified Play URL when an ebook edition exists. No fields are added for print-only volumes.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records. Book searches stop at Google's 600-result window; Play Books search returns at most 20.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 50,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Google Books & Play Books Catalog Explorer\n\nPull structured book data from Google Books, live ebook prices from Play Books, and word-frequency\ntrends from the Google Ngram Viewer — without an API key, login, cookie or proxy. One run can\nsearch a catalog, resolve ISBNs or volume IDs, browse an author or subject, compare Play Books\nprices, and export Ngram time series as rows.\n\n## What you get\n\n- **Book records** with volume ID, title and subtitle, all authors, publisher, publication date,\n  full description, page count, print type, ISBN-10/13 and other identifiers, language, BISAC\n  categories, average rating, viewability, embeddability, open-access flag, cover image, Google\n  Books page, preview page, and an optional Play Books URL with price and rating.\n- **Play Books cards** with title, series label, rating, current price, original price and sale\n  flag, cover, and the verified Play Books URL.\n- **Ngram rows** with phrase, phrase type (aggregate or case variant), parent phrase, year,\n  relative frequency, corpus, smoothing and a link to the graph.\n\nEvery record carries `sourceUrl`, `scrapedAt` and `recordType`. Empty values are omitted at every\ndepth, so you never get `null`, `\"\"`, `[]` or `{}` in a dataset.\n\n## Modes\n\n| Mode | What it does |\n|---|---|\n| `search` | Keyword search with Google Books operators: `intitle:`, `inauthor:`, `inpublisher:`, `subject:`, `isbn:`. Pages through results 20 at a time. |\n| `byVolumeIds` | Exact lookup from bare volume IDs or Google Books / Play Books URLs. Duplicates and invalid values are skipped. |\n| `byIsbn` | ISBN-10 or ISBN-13 lookup, one or many, with or without hyphens. |\n| `byAuthor` | Everything Google Books indexes under an author name (`inauthor:`). |\n| `bySubject` | Browse a BISAC-style subject or category (`subject:`). |\n| `playStoreSearch` | Search the Play Books storefront and return its first 20 ebook cards with live prices. |\n| `ngrams` | Google Ngram time series for one or many phrases, any supported corpus and year range. |\n\n## Inputs\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | What to fetch. |\n| `searchQuery` | string | `the lord of the rings` | Keywords for `search` or `playStoreSearch`. |\n| `volumeIds` | array | `[]` | Volume IDs or Google Books / Play URLs for `byVolumeIds`. |\n| `isbns` | array | `[]` | ISBN-10 or ISBN-13 values for `byIsbn`. |\n| `authorNames` | array | `[]` | Author names for `byAuthor`. |\n| `subjects` | array | `[]` | Subject/category names for `bySubject`. |\n| `ngramPhrases` | array | `[]` | Words or phrases for `ngrams`. |\n| `language` | string | `any` | Keep books in one language (applied to the fetched result window). |\n| `languageCode` | string | — | Exact language-code override (e.g. `eo`, `tl`); takes precedence over `language`. |\n| `viewability` | string | `all` | Filter to full view, preview, or no preview. |\n| `printType` | string | `all` | Books, magazines, or both. |\n| `freeEbooksOnly` | boolean | `false` | Keep only open-access volumes. |\n| `sortBy` | string | `relevance` | Relevance, or newest-first within the fetched result window. |\n| `ngramYearStart` | integer | `1800` | First Ngram year (1800–2022). |\n| `ngramYearEnd` | integer | `2019` | Last Ngram year (1800–2022). |\n| `ngramCorpus` | string | `en` | Ngram corpus: English, American/British English, English fiction, French, German, Spanish, Italian, Russian, Hebrew, Chinese. |\n| `ngramSmoothing` | integer | `3` | Smoothing window, 0–50. |\n| `ngramCaseInsensitive` | boolean | `true` | Emit a case-insensitive aggregate plus each case variant. |\n| `includeFullDetails` | boolean | `true` | Fetch each volume's detail feed for the full description and finer BISAC categories. |\n| `includePlayStoreDetails` | boolean | `true` | Check each volume's Play Books page for price, currency, rating and a verified Play link. |\n| `maxItems` | integer | `50` | Hard cap on emitted records. Daily prefill uses 3. |\n\nEnrichment is best-effort: a volume without a public Play ebook edition simply has no Play fields.\nThe daily-test prefill runs `search` on one query with `maxItems: 3` and both enrichment toggles\noff, so it costs one Google Books request.\n\n## Search operators\n\nGoogle Books accepts field prefixes inside `searchQuery`:\n\n```json\n{\"mode\": \"search\", \"searchQuery\": \"intitle:dune inauthor:herbert\", \"maxItems\": 20}\n```\n\n```json\n{\"mode\": \"search\", \"searchQuery\": \"subject:\\\"science fiction\\\" isbn:9780441013593\", \"maxItems\": 5}\n```\n\nOperators can be combined with spaces. Use `byAuthor` or `bySubject` when you want a dedicated\nauthor or category scan.\n\n## Examples\n\nSearch and enrich:\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"artificial intelligence\",\n  \"language\": \"en\",\n  \"viewability\": \"preview\",\n  \"sortBy\": \"newest\",\n  \"includeFullDetails\": true,\n  \"includePlayStoreDetails\": true,\n  \"maxItems\": 25\n}\n```\n\nExact volumes (both forms work):\n\n```json\n{\n  \"mode\": \"byVolumeIds\",\n  \"volumeIds\": [\"zyTCAlFPjgYC\", \"https://books.google.com/books?id=i9-wAAAAIAAJ\"],\n  \"maxItems\": 2\n}\n```\n\nPlay Books prices:\n\n```json\n{\"mode\": \"playStoreSearch\", \"searchQuery\": \"atomic habits\", \"maxItems\": 10}\n```\n\nNgram comparison:\n\n```json\n{\n  \"mode\": \"ngrams\",\n  \"ngramPhrases\": [\"dune\", \"foundation\"],\n  \"ngramYearStart\": 1950,\n  \"ngramYearEnd\": 2019,\n  \"ngramCorpus\": \"en-fiction\",\n  \"ngramSmoothing\": 3,\n  \"ngramCaseInsensitive\": true,\n  \"maxItems\": 2000\n}\n```\n\n## Output fields\n\n### Book record (`recordType: \"book\"`)\n\n`volumeId`, `title`, `subtitle`, `authors`, `primaryAuthor`, `publisher`, `publishedDate`,\n`publishedYear`, `description`, `pageCount`, `printType`, `isbn10`, `isbn13`,\n`otherIdentifiers`, `language`, `categories`, `averageRating`, `viewability`, `embeddable`,\n`openAccess`, `freeEbook`, `coverUrl`, `googleBooksUrl`, `previewUrl`, `playStoreUrl`,\n`playStorePrice`, `playStoreCurrency`, `playStoreIsFree`, `playStoreRating`,\n`playStoreRatingCount`, `query`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n### Play Books card (`recordType: \"playBook\"`)\n\n`playBookId`, `title`, `seriesInfo`, `rating`, `price`, `priceText`, `priceCurrency`,\n`originalPrice`, `originalPriceText`, `onSale`, `isFree`, `coverUrl`, `playStoreUrl`,\n`position`, `query`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n### Ngram row (`recordType: \"ngram\"`)\n\n`phrase`, `phraseType`, `parentPhrase`, `year`, `frequency`, `corpus`, `smoothing`,\n`caseInsensitive`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n## How pagination works\n\nGoogle Books returns 20 entries per request and exposes at most the first **600 results per\nquery** (`start-index` beyond 600 returns nothing). The actor keeps paging until `maxItems`, an\nempty page, or the 600-result window. For a very broad query, split it by subject, author, ISBN or\nanother field operator — each split has its own 600-result window. Play Books search returns its\nfirst 20 ebook cards; refine the query to see a different slice. Ngram requests are not paginated:\nall phrases are requested in one call and rows are capped by `maxItems`.\n\n## Prices\n\nPlay Books prices are read from the US storefront (`hl=en`, `gl=US`) at run time and reported in\nthe currency Play returns (normally USD). `playStoreSearch` fills a price for every card.\nPer-volume enrichment adds a price only when Google publishes an ebook edition for that exact\nvolume; print-only volumes get no Play fields. Sale cards expose both `price` and `originalPrice`\nplus `onSale`.\n\n## Limits and honest notes\n\n- **600 results per Google Books query.** This is a source window, not an actor setting.\n- **20 Play Books cards per search.** The storefront loads more results with internal calls that\n  are not part of the public page.\n- **Physical dimensions are not published** by the Books feed or the public book page.\n- **Download links are not emitted.** Google's EPUB/PDF download URLs redirect to a login or\n  return an empty signed response. Use `openAccess` / `freeEbook` to find free full-view books.\n- **Ratings are partial.** Google exposes an average for a subset of volumes; `includePlayStoreDetails`\n  fills a Play rating and rating count when an ebook edition exists.\n- **`sortBy: \"newest\"` sorts the fetched window**, because the Books feed ignores sort parameters.\n- **Ngram years run 1800–2022.** Rows outside the corpus' usable range can be zero.\n- **Descriptions are full only with `includeFullDetails`.** The search feed returns snippets; the\n  detail feed returns the publisher description when Google has it.\n- **No proxy or key is needed.** The actor uses Google's public Books feed, Play Books pages and\n  Ngram JSON directly.\n\n## FAQ\n\n**Do I need a Google API key?** No. The actor does not use the keyed Books API, which currently\nrate-limits anonymous callers.\n\n**Why did I get fewer rows than `maxItems`?** The query may have fewer matches, the filters may\nremove some, or the 600-result source window was reached. The run status message says which.\n\n**Why is one book missing a rating or price?** Google only rates some volumes, and Play only sells\nsome ebook editions. Missing values are omitted rather than estimated.\n\n**Can I get a book's full description?** Yes — leave `includeFullDetails` on (the default). It\ncosts one extra small request per record.\n\n**Can I query any language?** The `language` dropdown covers 74 common codes; `languageCode` accepts\nany exact ISO code as an override. Language filtering happens over the fetched window, so combine\nit with a specific query for best results.\n\n**Are prices historical?** No. Prices and availability are a snapshot of the US Play Store at run\ntime.\n\n## Data sources\n\nGoogle Books volume feeds (`books.google.com/books/feeds/volumes`), the Play Books storefront\n(`play.google.com/store/...c=books`) and the Google Ngram JSON endpoint\n(`books.google.com/ngrams/json`). This actor is not affiliated with Google.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "google-books-scraper",
      "title": "Google Books & Play Books Catalog Explorer",
      "description": "Search Google Books and Play Books by keyword, author, subject, ISBN or volume ID, and pull Ngram time series. Returns bibliographic metadata, ISBNs, BISAC categories, covers, previews, ratings, Play Books prices and word-frequency trends.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Google Books & Play Books Catalog Explorer\n\nPull structured book data from Google Books, live ebook prices from Play Books, and word-frequency\ntrends from the Google Ngram Viewer — without an API key, login, cookie or proxy. One run can\nsearch a catalog, resolve ISBNs or volume IDs, browse an author or subject, compare Play Books\nprices, and export Ngram time series as rows.\n\n## What you get\n\n- **Book records** with volume ID, title and subtitle, all authors, publisher, publication date,\n  full description, page count, print type, ISBN-10/13 and other identifiers, language, BISAC\n  categories, average rating, viewability, embeddability, open-access flag, cover image, Google\n  Books page, preview page, and an optional Play Books URL with price and rating.\n- **Play Books cards** with title, series label, rating, current price, original price and sale\n  flag, cover, and the verified Play Books URL.\n- **Ngram rows** with phrase, phrase type (aggregate or case variant), parent phrase, year,\n  relative frequency, corpus, smoothing and a link to the graph.\n\nEvery record carries `sourceUrl`, `scrapedAt` and `recordType`. Empty values are omitted at every\ndepth, so you never get `null`, `\"\"`, `[]` or `{}` in a dataset.\n\n## Modes\n\n| Mode | What it does |\n|---|---|\n| `search` | Keyword search with Google Books operators: `intitle:`, `inauthor:`, `inpublisher:`, `subject:`, `isbn:`. Pages through results 20 at a time. |\n| `byVolumeIds` | Exact lookup from bare volume IDs or Google Books / Play Books URLs. Duplicates and invalid values are skipped. |\n| `byIsbn` | ISBN-10 or ISBN-13 lookup, one or many, with or without hyphens. |\n| `byAuthor` | Everything Google Books indexes under an author name (`inauthor:`). |\n| `bySubject` | Browse a BISAC-style subject or category (`subject:`). |\n| `playStoreSearch` | Search the Play Books storefront and return its first 20 ebook cards with live prices. |\n| `ngrams` | Google Ngram time series for one or many phrases, any supported corpus and year range. |\n\n## Inputs\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | What to fetch. |\n| `searchQuery` | string | `the lord of the rings` | Keywords for `search` or `playStoreSearch`. |\n| `volumeIds` | array | `[]` | Volume IDs or Google Books / Play URLs for `byVolumeIds`. |\n| `isbns` | array | `[]` | ISBN-10 or ISBN-13 values for `byIsbn`. |\n| `authorNames` | array | `[]` | Author names for `byAuthor`. |\n| `subjects` | array | `[]` | Subject/category names for `bySubject`. |\n| `ngramPhrases` | array | `[]` | Words or phrases for `ngrams`. |\n| `language` | string | `any` | Keep books in one language (applied to the fetched result window). |\n| `languageCode` | string | — | Exact language-code override (e.g. `eo`, `tl`); takes precedence over `language`. |\n| `viewability` | string | `all` | Filter to full view, preview, or no preview. |\n| `printType` | string | `all` | Books, magazines, or both. |\n| `freeEbooksOnly` | boolean | `false` | Keep only open-access volumes. |\n| `sortBy` | string | `relevance` | Relevance, or newest-first within the fetched result window. |\n| `ngramYearStart` | integer | `1800` | First Ngram year (1800–2022). |\n| `ngramYearEnd` | integer | `2019` | Last Ngram year (1800–2022). |\n| `ngramCorpus` | string | `en` | Ngram corpus: English, American/British English, English fiction, French, German, Spanish, Italian, Russian, Hebrew, Chinese. |\n| `ngramSmoothing` | integer | `3` | Smoothing window, 0–50. |\n| `ngramCaseInsensitive` | boolean | `true` | Emit a case-insensitive aggregate plus each case variant. |\n| `includeFullDetails` | boolean | `true` | Fetch each volume's detail feed for the full description and finer BISAC categories. |\n| `includePlayStoreDetails` | boolean | `true` | Check each volume's Play Books page for price, currency, rating and a verified Play link. |\n| `maxItems` | integer | `50` | Hard cap on emitted records. Daily prefill uses 3. |\n\nEnrichment is best-effort: a volume without a public Play ebook edition simply has no Play fields.\nThe daily-test prefill runs `search` on one query with `maxItems: 3` and both enrichment toggles\noff, so it costs one Google Books request.\n\n## Search operators\n\nGoogle Books accepts field prefixes inside `searchQuery`:\n\n```json\n{\"mode\": \"search\", \"searchQuery\": \"intitle:dune inauthor:herbert\", \"maxItems\": 20}\n```\n\n```json\n{\"mode\": \"search\", \"searchQuery\": \"subject:\\\"science fiction\\\" isbn:9780441013593\", \"maxItems\": 5}\n```\n\nOperators can be combined with spaces. Use `byAuthor` or `bySubject` when you want a dedicated\nauthor or category scan.\n\n## Examples\n\nSearch and enrich:\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"artificial intelligence\",\n  \"language\": \"en\",\n  \"viewability\": \"preview\",\n  \"sortBy\": \"newest\",\n  \"includeFullDetails\": true,\n  \"includePlayStoreDetails\": true,\n  \"maxItems\": 25\n}\n```\n\nExact volumes (both forms work):\n\n```json\n{\n  \"mode\": \"byVolumeIds\",\n  \"volumeIds\": [\"zyTCAlFPjgYC\", \"https://books.google.com/books?id=i9-wAAAAIAAJ\"],\n  \"maxItems\": 2\n}\n```\n\nPlay Books prices:\n\n```json\n{\"mode\": \"playStoreSearch\", \"searchQuery\": \"atomic habits\", \"maxItems\": 10}\n```\n\nNgram comparison:\n\n```json\n{\n  \"mode\": \"ngrams\",\n  \"ngramPhrases\": [\"dune\", \"foundation\"],\n  \"ngramYearStart\": 1950,\n  \"ngramYearEnd\": 2019,\n  \"ngramCorpus\": \"en-fiction\",\n  \"ngramSmoothing\": 3,\n  \"ngramCaseInsensitive\": true,\n  \"maxItems\": 2000\n}\n```\n\n## Output fields\n\n### Book record (`recordType: \"book\"`)\n\n`volumeId`, `title`, `subtitle`, `authors`, `primaryAuthor`, `publisher`, `publishedDate`,\n`publishedYear`, `description`, `pageCount`, `printType`, `isbn10`, `isbn13`,\n`otherIdentifiers`, `language`, `categories`, `averageRating`, `viewability`, `embeddable`,\n`openAccess`, `freeEbook`, `coverUrl`, `googleBooksUrl`, `previewUrl`, `playStoreUrl`,\n`playStorePrice`, `playStoreCurrency`, `playStoreIsFree`, `playStoreRating`,\n`playStoreRatingCount`, `query`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n### Play Books card (`recordType: \"playBook\"`)\n\n`playBookId`, `title`, `seriesInfo`, `rating`, `price`, `priceText`, `priceCurrency`,\n`originalPrice`, `originalPriceText`, `onSale`, `isFree`, `coverUrl`, `playStoreUrl`,\n`position`, `query`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n### Ngram row (`recordType: \"ngram\"`)\n\n`phrase`, `phraseType`, `parentPhrase`, `year`, `frequency`, `corpus`, `smoothing`,\n`caseInsensitive`, `sourceUrl`, `scrapedAt`, `recordType`.\n\n## How pagination works\n\nGoogle Books returns 20 entries per request and exposes at most the first **600 results per\nquery** (`start-index` beyond 600 returns nothing). The actor keeps paging until `maxItems`, an\nempty page, or the 600-result window. For a very broad query, split it by subject, author, ISBN or\nanother field operator — each split has its own 600-result window. Play Books search returns its\nfirst 20 ebook cards; refine the query to see a different slice. Ngram requests are not paginated:\nall phrases are requested in one call and rows are capped by `maxItems`.\n\n## Prices\n\nPlay Books prices are read from the US storefront (`hl=en`, `gl=US`) at run time and reported in\nthe currency Play returns (normally USD). `playStoreSearch` fills a price for every card.\nPer-volume enrichment adds a price only when Google publishes an ebook edition for that exact\nvolume; print-only volumes get no Play fields. Sale cards expose both `price` and `originalPrice`\nplus `onSale`.\n\n## Limits and honest notes\n\n- **600 results per Google Books query.** This is a source window, not an actor setting.\n- **20 Play Books cards per search.** The storefront loads more results with internal calls that\n  are not part of the public page.\n- **Physical dimensions are not published** by the Books feed or the public book page.\n- **Download links are not emitted.** Google's EPUB/PDF download URLs redirect to a login or\n  return an empty signed response. Use `openAccess` / `freeEbook` to find free full-view books.\n- **Ratings are partial.** Google exposes an average for a subset of volumes; `includePlayStoreDetails`\n  fills a Play rating and rating count when an ebook edition exists.\n- **`sortBy: \"newest\"` sorts the fetched window**, because the Books feed ignores sort parameters.\n- **Ngram years run 1800–2022.** Rows outside the corpus' usable range can be zero.\n- **Descriptions are full only with `includeFullDetails`.** The search feed returns snippets; the\n  detail feed returns the publisher description when Google has it.\n- **No proxy or key is needed.** The actor uses Google's public Books feed, Play Books pages and\n  Ngram JSON directly.\n\n## FAQ\n\n**Do I need a Google API key?** No. The actor does not use the keyed Books API, which currently\nrate-limits anonymous callers.\n\n**Why did I get fewer rows than `maxItems`?** The query may have fewer matches, the filters may\nremove some, or the 600-result source window was reached. The run status message says which.\n\n**Why is one book missing a rating or price?** Google only rates some volumes, and Play only sells\nsome ebook editions. Missing values are omitted rather than estimated.\n\n**Can I get a book's full description?** Yes — leave `includeFullDetails` on (the default). It\ncosts one extra small request per record.\n\n**Can I query any language?** The `language` dropdown covers 74 common codes; `languageCode` accepts\nany exact ISO code as an override. Language filtering happens over the fetched window, so combine\nit with a specific query for best results.\n\n**Are prices historical?** No. Prices and availability are a snapshot of the US Play Store at run\ntime.\n\n## Data sources\n\nGoogle Books volume feeds (`books.google.com/books/feeds/volumes`), the Play Books storefront\n(`play.google.com/store/...c=books`) and the Google Ngram JSON endpoint\n(`books.google.com/ngrams/json`). This actor is not affiliated with Google.\n",
      "input": {
        "title": "Google Books & Play Books Catalog Explorer Input",
        "description": "Search Google Books by keyword, author, subject, ISBN or volume ID, search Play Books with live prices, or pull Google Ngram time series.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch. Each mode reads its own input block below.",
            "editor": "select",
            "enum": [
              "search",
              "byVolumeIds",
              "byIsbn",
              "byAuthor",
              "bySubject",
              "playStoreSearch",
              "ngrams"
            ],
            "enumTitles": [
              "Search the Google Books catalog",
              "Look up volumes by ID or URL",
              "Look up ISBNs",
              "Books by author",
              "Books by subject / category",
              "Play Books store search with prices",
              "Ngram word-frequency time series"
            ],
            "default": "search",
            "prefill": "search",
            "sectionCaption": "What to fetch",
            "sectionDescription": "Pick a catalog search, exact lookup, Play Books price search or Ngram time series."
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Keywords for mode=search or mode=playStoreSearch. Google Books operators work: `intitle:`, `inauthor:`, `inpublisher:`, `subject:`, `isbn:`, combinable with spaces/OR. Example: `intitle:dune inauthor:herbert`.",
            "editor": "textfield",
            "default": "the lord of the rings",
            "prefill": "the lord of the rings",
            "sectionCaption": "Search and lookup inputs",
            "sectionDescription": "Fill only the block used by the selected mode."
          },
          "volumeIds": {
            "title": "Volume IDs or URLs (mode=byVolumeIds)",
            "type": "array",
            "description": "Google Books volume IDs (e.g. `zyTCAlFPjgYC`) or Books/Play URLs containing `id=`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "isbns": {
            "title": "ISBNs (mode=byIsbn)",
            "type": "array",
            "description": "ISBN-10 or ISBN-13 values, with or without hyphens.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "authorNames": {
            "title": "Author names (mode=byAuthor)",
            "type": "array",
            "description": "Author names to search with Google Books' `inauthor:` operator, e.g. `Frank Herbert`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "subjects": {
            "title": "Subjects / categories (mode=bySubject)",
            "type": "array",
            "description": "BISAC-style subject names to search with `subject:`, e.g. `Science Fiction`, `Business & Economics`, `Juvenile Fiction`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "ngramPhrases": {
            "title": "Phrases (mode=ngrams)",
            "type": "array",
            "description": "Words or phrases to compare, e.g. `dune`, `artificial intelligence`, `climate change`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "language": {
            "title": "Language (book modes)",
            "type": "string",
            "description": "Keep books in one language. Applied to the fetched result window. Use `languageCode` for a code not listed.",
            "editor": "select",
            "enum": [
              "any",
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "nl",
              "ru",
              "ja",
              "zh",
              "ko",
              "ar",
              "he",
              "hi",
              "tr",
              "pl",
              "sv",
              "da",
              "fi",
              "no",
              "el",
              "cs",
              "hu",
              "ro",
              "uk",
              "vi",
              "th",
              "id",
              "ms",
              "fa",
              "sw",
              "la",
              "ca",
              "hr",
              "sk",
              "sl",
              "sr",
              "bg",
              "lt",
              "lv",
              "et",
              "is",
              "ga",
              "cy",
              "af",
              "sq",
              "mk",
              "bs",
              "ka",
              "hy",
              "az",
              "kk",
              "uz",
              "bn",
              "ta",
              "te",
              "ml",
              "kn",
              "mr",
              "gu",
              "pa",
              "ur",
              "ne",
              "si",
              "km",
              "lo",
              "my",
              "mn",
              "bo",
              "eu",
              "gl",
              "mt",
              "lb",
              "eo"
            ],
            "enumTitles": [
              "Any language",
              "EN",
              "ES",
              "FR",
              "DE",
              "IT",
              "PT",
              "NL",
              "RU",
              "JA",
              "ZH",
              "KO",
              "AR",
              "HE",
              "HI",
              "TR",
              "PL",
              "SV",
              "DA",
              "FI",
              "NO",
              "EL",
              "CS",
              "HU",
              "RO",
              "UK",
              "VI",
              "TH",
              "ID",
              "MS",
              "FA",
              "SW",
              "LA",
              "CA",
              "HR",
              "SK",
              "SL",
              "SR",
              "BG",
              "LT",
              "LV",
              "ET",
              "IS",
              "GA",
              "CY",
              "AF",
              "SQ",
              "MK",
              "BS",
              "KA",
              "HY",
              "AZ",
              "KK",
              "UZ",
              "BN",
              "TA",
              "TE",
              "ML",
              "KN",
              "MR",
              "GU",
              "PA",
              "UR",
              "NE",
              "SI",
              "KM",
              "LO",
              "MY",
              "MN",
              "BO",
              "EU",
              "GL",
              "MT",
              "LB",
              "EO"
            ],
            "default": "any",
            "prefill": "any",
            "sectionCaption": "Book filters",
            "sectionDescription": "Client-side filters applied to search, author, subject and ISBN result sets."
          },
          "languageCode": {
            "title": "Language code override (book modes)",
            "type": "string",
            "description": "Optional exact ISO 639-1/639-2 code (e.g. `eo`, `tl`). Takes precedence over the Language dropdown.",
            "editor": "textfield"
          },
          "viewability": {
            "title": "Viewability (book modes)",
            "type": "string",
            "description": "Filter by how much of the book Google shows: full view, preview or no preview.",
            "editor": "select",
            "enum": [
              "all",
              "full",
              "preview",
              "none"
            ],
            "enumTitles": [
              "Any viewability",
              "Full view",
              "Preview only",
              "No preview"
            ],
            "default": "all",
            "prefill": "all"
          },
          "printType": {
            "title": "Print type (book modes)",
            "type": "string",
            "description": "Restrict results to books or magazines.",
            "editor": "select",
            "enum": [
              "all",
              "books",
              "magazines"
            ],
            "enumTitles": [
              "Books and magazines",
              "Books only",
              "Magazines only"
            ],
            "default": "all",
            "prefill": "all"
          },
          "freeEbooksOnly": {
            "title": "Free ebooks only (book modes)",
            "type": "boolean",
            "description": "Keep only open-access volumes (public-domain or free full-view books).",
            "default": false,
            "prefill": false
          },
          "sortBy": {
            "title": "Sort order (book modes)",
            "type": "string",
            "description": "Relevance keeps Google's order. Newest sorts the fetched result window by publication date, newest first.",
            "editor": "select",
            "enum": [
              "relevance",
              "newest"
            ],
            "enumTitles": [
              "Relevance",
              "Newest first"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "ngramYearStart": {
            "title": "Start year (mode=ngrams)",
            "type": "integer",
            "description": "First year of the Ngram time series (1800–2022).",
            "minimum": 1800,
            "maximum": 2022,
            "default": 1800,
            "prefill": 1800,
            "sectionCaption": "Ngram options",
            "sectionDescription": "Only used when mode=ngrams."
          },
          "ngramYearEnd": {
            "title": "End year (mode=ngrams)",
            "type": "integer",
            "description": "Last year of the Ngram time series (1800–2022). Must be at least the start year.",
            "minimum": 1800,
            "maximum": 2022,
            "default": 2019,
            "prefill": 2019
          },
          "ngramCorpus": {
            "title": "Corpus (mode=ngrams)",
            "type": "string",
            "description": "Google Books Ngram corpus to query.",
            "editor": "select",
            "enum": [
              "en",
              "en-US",
              "en-GB",
              "en-fiction",
              "fr",
              "de",
              "es",
              "it",
              "ru",
              "he",
              "zh"
            ],
            "enumTitles": [
              "English (all)",
              "American English",
              "British English",
              "English fiction",
              "French",
              "German",
              "Spanish",
              "Italian",
              "Russian",
              "Hebrew",
              "Chinese (simplified)"
            ],
            "default": "en",
            "prefill": "en"
          },
          "ngramSmoothing": {
            "title": "Smoothing (mode=ngrams)",
            "type": "integer",
            "description": "Smoothing window, 0 (none) to 50. Google's default is 3.",
            "minimum": 0,
            "maximum": 50,
            "default": 3,
            "prefill": 3
          },
          "ngramCaseInsensitive": {
            "title": "Group case variants (mode=ngrams)",
            "type": "boolean",
            "description": "When on, emit a case-insensitive aggregate plus one row per case variant.",
            "default": true,
            "prefill": true
          },
          "includeFullDetails": {
            "title": "Fetch full volume details",
            "type": "boolean",
            "description": "Book modes only. Fetch each volume's detail feed for the full description and finer BISAC categories. One extra small request per record; off in the daily prefill.",
            "default": true,
            "prefill": false,
            "sectionCaption": "Output and enrichment",
            "sectionDescription": "Control enrichment requests and the record cap."
          },
          "includePlayStoreDetails": {
            "title": "Fetch Play Books price & rating",
            "type": "boolean",
            "description": "Book modes only. Check each volume's Play Books page and add price, currency, rating and the verified Play URL when an ebook edition exists. No fields are added for print-only volumes.",
            "default": true,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records. Book searches stop at Google's 600-result window; Play Books search returns at most 20.",
            "minimum": 1,
            "maximum": 5000,
            "default": 50,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Google Books & Play Books Catalog Explorer Output",
        "type": "object",
        "description": "Book records, Play Books ebook cards or Ngram phrase/year rows, depending on the selected mode.",
        "properties": {
          "results": {
            "type": "string",
            "title": "Results",
            "description": "Dataset containing book records, Play Books cards or Ngram time-series rows.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "defaultMemoryMbytes": 512,
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "books": {
              "title": "Books",
              "transformation": {
                "fields": [
                  "title",
                  "authors",
                  "publishedDate",
                  "language",
                  "averageRating",
                  "playStorePrice",
                  "googleBooksUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            },
            "playBooks": {
              "title": "Play Books",
              "transformation": {
                "fields": [
                  "title",
                  "seriesInfo",
                  "rating",
                  "price",
                  "priceText",
                  "playStoreUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            },
            "ngrams": {
              "title": "Ngram trends",
              "transformation": {
                "fields": [
                  "phrase",
                  "phraseType",
                  "year",
                  "frequency",
                  "corpus"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "03c3bb7cfc97c4ae5d0cc1f1c31ed1e890e36399acc0e797444d41cb0bd12b82",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0032733333333333334
    }
  }
}