{
  "data": {
    "id": "vapO20YerJ3EhCrWa",
    "actId": "r0PyEw3l6e0a8bvSC",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-11-16T00:59:28.624Z",
    "finishedAt": "2026-11-16T00:59:30.844Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 2157,
      "runTimeSecs": 2.157,
      "computeUnits": 0.0023966666666666667,
      "imageSizeBytes": 343273984
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Amazon Books Intelligence Input\",\n  \"description\": \"Search Amazon Books, fetch book details, crawl an author's catalogue, read a series in order, or collect Kindle/book deals. All data is public and cookieless.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to collect.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"details\",\n        \"author\",\n        \"series\",\n        \"deals\"\n      ],\n      \"enumTitles\": [\n        \"Search books by keyword\",\n        \"Book details by ASIN or URL\",\n        \"Author catalogue (all books)\",\n        \"Book series in reading order\",\n        \"Kindle and book deals\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"searchQueries\": {\n      \"title\": \"Search queries (mode=search)\",\n      \"type\": \"array\",\n      \"description\": \"One or more Amazon Books search queries, e.g. `harry potter`, `brandon sanderson`, `cozy fantasy`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": [\n        \"harry potter\"\n      ]\n    },\n    \"asins\": {\n      \"title\": \"ASINs (mode=details / series)\",\n      \"type\": \"array\",\n      \"description\": \"Amazon ASINs. In details mode each ASIN is a book; in series mode each ASIN is a series page ASIN. Bare ASINs or full Amazon URLs are accepted.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"bookUrls\": {\n      \"title\": \"Book or series URLs (mode=details / series)\",\n      \"type\": \"array\",\n      \"description\": \"Full Amazon book or series URLs. ASINs are extracted automatically.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"authorIds\": {\n      \"title\": \"Author IDs or store URLs (mode=author)\",\n      \"type\": \"array\",\n      \"description\": \"Amazon author IDs (e.g. `B001IGFHW6`) or author-store URLs such as `https://www.amazon.com/stores/author/B001IGFHW6`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"marketplace\": {\n      \"title\": \"Amazon marketplace\",\n      \"type\": \"string\",\n      \"description\": \"Amazon site to read. Prices and availability follow the site plus the delivery setting.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"amazon.com\",\n        \"amazon.co.uk\",\n        \"amazon.de\",\n        \"amazon.fr\",\n        \"amazon.it\",\n        \"amazon.es\",\n        \"amazon.ca\",\n        \"amazon.com.au\",\n        \"amazon.co.jp\",\n        \"amazon.in\",\n        \"amazon.com.br\",\n        \"amazon.com.mx\",\n        \"amazon.nl\",\n        \"amazon.com.be\",\n        \"amazon.se\",\n        \"amazon.pl\",\n        \"amazon.com.tr\",\n        \"amazon.ae\",\n        \"amazon.sa\",\n        \"amazon.eg\",\n        \"amazon.sg\"\n      ],\n      \"enumTitles\": [\n        \"United States (amazon.com)\",\n        \"United Kingdom (amazon.co.uk)\",\n        \"Germany (amazon.de)\",\n        \"France (amazon.fr)\",\n        \"Italy (amazon.it)\",\n        \"Spain (amazon.es)\",\n        \"Canada (amazon.ca)\",\n        \"Australia (amazon.com.au)\",\n        \"Japan (amazon.co.jp)\",\n        \"India (amazon.in)\",\n        \"Brazil (amazon.com.br)\",\n        \"Mexico (amazon.com.mx)\",\n        \"Netherlands (amazon.nl)\",\n        \"Belgium (amazon.com.be)\",\n        \"Sweden (amazon.se)\",\n        \"Poland (amazon.pl)\",\n        \"Turkey (amazon.com.tr)\",\n        \"United Arab Emirates (amazon.ae)\",\n        \"Saudi Arabia (amazon.sa)\",\n        \"Egypt (amazon.eg)\",\n        \"Singapore (amazon.sg)\"\n      ],\n      \"default\": \"amazon.com\",\n      \"prefill\": \"amazon.com\"\n    },\n    \"currency\": {\n      \"title\": \"Display currency\",\n      \"type\": \"string\",\n      \"description\": \"Currency Amazon shows on the page. `Auto` uses the marketplace currency.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"auto\",\n        \"USD\",\n        \"GBP\",\n        \"EUR\",\n        \"CAD\",\n        \"AUD\",\n        \"JPY\",\n        \"INR\",\n        \"BRL\",\n        \"MXN\",\n        \"SEK\",\n        \"PLN\",\n        \"TRY\",\n        \"AED\",\n        \"SAR\",\n        \"EGP\",\n        \"SGD\"\n      ],\n      \"enumTitles\": [\n        \"Auto (marketplace currency)\",\n        \"US dollar\",\n        \"British pound\",\n        \"Euro\",\n        \"Canadian dollar\",\n        \"Australian dollar\",\n        \"Japanese yen\",\n        \"Indian rupee\",\n        \"Brazilian real\",\n        \"Mexican peso\",\n        \"Swedish krona\",\n        \"Polish zloty\",\n        \"Turkish lira\",\n        \"UAE dirham\",\n        \"Saudi riyal\",\n        \"Egyptian pound\",\n        \"Singapore dollar\"\n      ],\n      \"default\": \"auto\",\n      \"prefill\": \"auto\"\n    },\n    \"deliveryCountry\": {\n      \"title\": \"Delivery country\",\n      \"type\": \"string\",\n      \"description\": \"Ship-to country used for prices and availability. `Auto` leaves Amazon's detected location unchanged.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"auto\",\n        \"US\",\n        \"GB\",\n        \"DE\",\n        \"FR\",\n        \"IT\",\n        \"ES\",\n        \"CA\",\n        \"AU\",\n        \"JP\",\n        \"IN\",\n        \"BR\",\n        \"MX\",\n        \"NL\",\n        \"BE\",\n        \"SE\",\n        \"PL\",\n        \"TR\",\n        \"AE\",\n        \"SA\",\n        \"EG\",\n        \"SG\"\n      ],\n      \"enumTitles\": [\n        \"Auto (Amazon default)\",\n        \"United States\",\n        \"United Kingdom\",\n        \"Germany\",\n        \"France\",\n        \"Italy\",\n        \"Spain\",\n        \"Canada\",\n        \"Australia\",\n        \"Japan\",\n        \"India\",\n        \"Brazil\",\n        \"Mexico\",\n        \"Netherlands\",\n        \"Belgium\",\n        \"Sweden\",\n        \"Poland\",\n        \"Turkey\",\n        \"United Arab Emirates\",\n        \"Saudi Arabia\",\n        \"Egypt\",\n        \"Singapore\"\n      ],\n      \"default\": \"auto\",\n      \"prefill\": \"auto\"\n    },\n    \"deliveryPostalCode\": {\n      \"title\": \"Delivery postal code\",\n      \"type\": \"string\",\n      \"description\": \"Optional ZIP/postal code for the delivery country. Leave empty to use a representative local code.\",\n      \"editor\": \"textfield\"\n    },\n    \"searchSort\": {\n      \"title\": \"Search sort (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"Result order for keyword search.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"price-asc\",\n        \"price-desc\",\n        \"review\",\n        \"newest\",\n        \"bestseller\"\n      ],\n      \"enumTitles\": [\n        \"Relevance\",\n        \"Price: low to high\",\n        \"Price: high to low\",\n        \"Average customer review\",\n        \"Newest publication date\",\n        \"Bestseller rank\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"authorSort\": {\n      \"title\": \"Author sort (mode=author)\",\n      \"type\": \"string\",\n      \"description\": \"Catalogue order for author mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"popularity\",\n        \"price-asc\",\n        \"price-desc\",\n        \"review\",\n        \"newest\",\n        \"most-reviews\"\n      ],\n      \"enumTitles\": [\n        \"Popularity\",\n        \"Price: low to high\",\n        \"Price: high to low\",\n        \"Average customer review\",\n        \"Newest publication date\",\n        \"Most reviews\"\n      ],\n      \"default\": \"popularity\",\n      \"prefill\": \"popularity\"\n    },\n    \"format\": {\n      \"title\": \"Book format\",\n      \"type\": \"string\",\n      \"description\": \"Filter by binding. Search mode uses the Kindle/Audible storefronts for those formats and filters the rest on the result card.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"kindle\",\n        \"paperback\",\n        \"hardcover\",\n        \"audiobook\",\n        \"mass-market\",\n        \"board-book\"\n      ],\n      \"enumTitles\": [\n        \"All formats\",\n        \"Kindle eBook\",\n        \"Paperback\",\n        \"Hardcover\",\n        \"Audiobook\",\n        \"Mass market paperback\",\n        \"Board book\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"authorLanguage\": {\n      \"title\": \"Book language (mode=author)\",\n      \"type\": \"string\",\n      \"description\": \"Language filter on the author catalogue. Only the languages Amazon exposes for author pages are listed.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"All Languages\",\n        \"Catalan\",\n        \"Chinese (Simplified)\",\n        \"English\",\n        \"French\",\n        \"German\",\n        \"Greek\",\n        \"Italian\",\n        \"Japanese\",\n        \"Portuguese\",\n        \"Spanish\"\n      ],\n      \"enumTitles\": [\n        \"All languages\",\n        \"Catalan\",\n        \"Chinese (Simplified)\",\n        \"English\",\n        \"French\",\n        \"German\",\n        \"Greek\",\n        \"Italian\",\n        \"Japanese\",\n        \"Portuguese\",\n        \"Spanish\"\n      ],\n      \"default\": \"All Languages\",\n      \"prefill\": \"All Languages\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price\",\n      \"type\": \"number\",\n      \"description\": \"Drop records priced below this amount.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price\",\n      \"type\": \"number\",\n      \"description\": \"Drop records priced above this amount.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"number\",\n      \"description\": \"Drop records rated below this value (1-5).\",\n      \"minimum\": 1,\n      \"maximum\": 5\n    },\n    \"maxRating\": {\n      \"title\": \"Maximum rating\",\n      \"type\": \"number\",\n      \"description\": \"Drop records rated above this value (1-5).\",\n      \"minimum\": 1,\n      \"maximum\": 5\n    },\n    \"minDiscountPercent\": {\n      \"title\": \"Minimum discount % (mode=deals)\",\n      \"type\": \"number\",\n      \"description\": \"Keep only deals at or above this discount.\",\n      \"minimum\": 0,\n      \"maximum\": 100\n    },\n    \"publishedAfter\": {\n      \"title\": \"Published after\",\n      \"type\": \"string\",\n      \"description\": \"ISO date `YYYY-MM-DD`. Records without a publication date pass through.\",\n      \"editor\": \"textfield\"\n    },\n    \"publishedBefore\": {\n      \"title\": \"Published before\",\n      \"type\": \"string\",\n      \"description\": \"ISO date `YYYY-MM-DD`. Records without a publication date pass through.\",\n      \"editor\": \"textfield\"\n    },\n    \"titleContains\": {\n      \"title\": \"Title contains\",\n      \"type\": \"string\",\n      \"description\": \"Case-insensitive substring filter on the book title.\",\n      \"editor\": \"textfield\"\n    },\n    \"excludeKeywords\": {\n      \"title\": \"Exclude title keywords\",\n      \"type\": \"string\",\n      \"description\": \"Comma-separated words; records whose title contains any of them are dropped.\",\n      \"editor\": \"textfield\"\n    },\n    \"includeSponsored\": {\n      \"title\": \"Include sponsored results\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep Amazon sponsored search placements in search mode.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"includeDetails\": {\n      \"title\": \"Enrich with detail pages\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each book's detail page for publisher, page count, ISBN, BSR and description. Slower and uses more requests.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 50,\n      \"prefill\": 3\n    },\n    \"maxPages\": {\n      \"title\": \"Max pages\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum result/catalogue pages to read per query or author.\",\n      \"minimum\": 1,\n      \"maximum\": 50,\n      \"default\": 10,\n      \"prefill\": 1\n    },\n    \"proxyConfiguration\": {\n      \"title\": \"Proxy configuration (optional)\",\n      \"type\": \"object\",\n      \"description\": \"Optional Apify Proxy override. The actor works without a proxy and selects its own retry strategy automatically.\",\n      \"editor\": \"proxy\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Amazon Books Intelligence: Authors, Series & Kindle Deals\n\nAmazon's book catalogue is bigger than a keyword search box. This actor reads the book-specific surfaces that generic product scrapers skip:\n\n- **Search** the Books, Kindle and Audible catalogues and get clean, filterable rows.\n- **Read an author's complete catalogue** from an author store, including books that never surface in a keyword search, with the author bio, photo and total catalogue size.\n- **Follow a series** in reading order with positions, publication dates, contributors and Goodreads ratings.\n- **Collect Kindle and book deals** with the deal price, list price, discount and deal badge.\n- **Enrich any row** with its detail page for publisher, publication date, page count, ISBN, file size, best-seller rank and full description.\n\nEverything is public and cookieless. No Amazon login, cookie, API key or proxy setup is needed.\n\n## Modes\n\n| Mode | What it returns | Required input |\n|---|---|---|\n| `search` | One row per book from Amazon Books / Kindle / Audible search results | `searchQueries` |\n| `details` | One row per ASIN with the full detail page fields | `asins` or `bookUrls` |\n| `author` | Every book in an author's catalogue, newest first or by any sort | `authorIds` |\n| `series` | Every book in a series, in reading order | `asins` or `bookUrls` (series ASINs) |\n| `deals` | Today's Kindle and book deals, one row per deal | none |\n\n## Input examples\n\n### Search books\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"cozy fantasy\", \"brandon sanderson\"],\n  \"marketplace\": \"amazon.com\",\n  \"format\": \"kindle\",\n  \"searchSort\": \"review\",\n  \"minRating\": 4,\n  \"maxItems\": 50\n}\n```\n\n### Author catalogue\n\n```json\n{\n  \"mode\": \"author\",\n  \"authorIds\": [\"B001IGFHW6\"],\n  \"authorSort\": \"newest\",\n  \"authorLanguage\": \"English\",\n  \"maxItems\": 200\n}\n```\n\n### Series reading order\n\n```json\n{\n  \"mode\": \"series\",\n  \"asins\": [\"B0F11YD12X\"],\n  \"maxItems\": 50\n}\n```\n\n### Book details with enrichment\n\n```json\n{\n  \"mode\": \"details\",\n  \"asins\": [\"B0BPNB19CL\", \"059035342X\"],\n  \"bookUrls\": [\"https://www.amazon.com/dp/1408856778\"],\n  \"includeDetails\": true\n}\n```\n\n### Kindle and book deals\n\n```json\n{\n  \"mode\": \"deals\",\n  \"format\": \"kindle\",\n  \"minDiscountPercent\": 50,\n  \"maxItems\": 100\n}\n```\n\n## What each row contains\n\nEvery row includes:\n\n- `recordType`: `bookSearch`, `bookDetail`, `authorBook`, `seriesBook` or `bookDeal`\n- `asin`, `title`, `sourceUrl`, `marketplace`, `currency`, `scrapedAt`\n- `authors`, `primaryAuthor`, `contributors` with roles and profile links\n- `format`, `formatGroup`, `formats` (when the page lists other bindings)\n- `price`, `listPrice` as `{value, currency, display}` objects\n- `rating`, `reviewCount`, `savingsPercent`, `savingsAmount`\n- `seriesTitle`, `seriesPosition`, `seriesTotal`, `seriesUrl`\n- `coverImageUrl`, `imageUrls`\n- `sponsored`, `bestSeller`, `editorsPick`, `amazonsChoice`, `kindleUnlimited`\n- `page`, `positionOnPage` for search results\n\nDetail-enriched rows add:\n\n- `publisher`, `publicationDate`, `publicationDateText`, `language`\n- `pageCount`, `isbn10`, `isbn13`, `fileSize`, `dimensions`, `readingAge`\n- `bestSellersRanks` (all ranks shown) and `bestSellersRankPrimary`\n- `description`, `availability`\n\nAuthor rows add:\n\n- `author`: `{authorId, authorName, authorBio, authorPhotoUrl, authorBookCount, authorUrl}`\n\nDeal rows add:\n\n- `dealCollection`, `dealRefTag`, `dealBadge`, `dealMessage`\n\nEmpty fields are omitted. A missing field never becomes `null`, `\"\"` or a sentinel value.\n\n## How it works\n\n1. Opens a fresh Amazon session with a mobile browser profile and seeds the requested display currency.\n2. Reads the requested surface: the mobile search endpoint, a product page, an author store and its product-grid API, the series `seriesAsinList` endpoint, or the book-deals page.\n3. Parses the embedded JSON first and falls back to the rendered HTML.\n4. Rotates the session, backs off and retries when Amazon returns a bot-check or a 429/5xx page.\n5. Pushes one clean record per book and stops at `maxItems`.\n\nThe author mode reads the complete catalogue through Amazon's own paginated product grid, not just the first visible shelf. Series mode walks every `seriesAsinList` page until no new ASINs arrive.\n\n## Input reference\n\n| Field | Type | Notes |\n|---|---|---|\n| `mode` | select | `search`, `details`, `author`, `series`, `deals` |\n| `searchQueries` | string list | Search mode queries |\n| `asins` | string list | Book ASINs (details) or series ASINs (series) |\n| `bookUrls` | string list | Full Amazon URLs; ASINs are extracted |\n| `authorIds` | string list | Author IDs or author-store URLs |\n| `marketplace` | select | 21 Amazon marketplaces |\n| `currency` | select | Display currency; `auto` follows the marketplace |\n| `deliveryCountry` | select | Ship-to country for price/availability |\n| `deliveryPostalCode` | text | Optional postal/ZIP code for the delivery country |\n| `searchSort` | select | relevance, price, review, newest, bestseller |\n| `authorSort` | select | popularity, price, review, newest, most reviews |\n| `format` | select | all, kindle, paperback, hardcover, audiobook, mass market, board book |\n| `authorLanguage` | select | Author-catalogue language filter |\n| `minPrice` / `maxPrice` | number | Price bounds |\n| `minRating` / `maxRating` | number | Rating bounds |\n| `minDiscountPercent` | number | Deal discount floor |\n| `publishedAfter` / `publishedBefore` | date | ISO date bounds; unknown dates pass |\n| `titleContains` | text | Substring filter |\n| `excludeKeywords` | text | Comma-separated title exclusions |\n| `includeSponsored` | boolean | Keep sponsored search placements |\n| `includeDetails` | boolean | Fetch every book's detail page |\n| `maxItems` | integer | 1-1000, default 50 |\n| `maxPages` | integer | 1-50, default 10 |\n| `proxyConfiguration` | object | Optional Apify Proxy override |\n\n\n## Defaults\n\n| Field | Default |\n|---|---|\n| `mode` | `search` |\n| `marketplace` | `amazon.com` |\n| `currency` | `auto` |\n| `deliveryCountry` | `auto` |\n| `searchSort` | `relevance` |\n| `authorSort` | `popularity` |\n| `format` | `all` |\n| `authorLanguage` | `All Languages` |\n| `includeSponsored` | `true` |\n| `includeDetails` | `false` |\n| `maxItems` | `50` (prefill `3`) |\n| `maxPages` | `10` (prefill `1`) |\n\n## Limits and notes\n\n- Amazon shows different prices by delivery location. Set `deliveryCountry` (and optionally `deliveryPostalCode`) when you need a specific store's price. The actor still returns data without it.\n- Search result cards do not expose every detail field. Turn on `includeDetails` when you need publisher, page count, ISBN, BSR or the full description.\n- A few books have no public price (pre-orders, third-party-only listings, unavailable titles). The `price` field is omitted rather than invented.\n- Author catalogues can contain hundreds of editions. `maxItems` and `maxPages` keep a run bounded; raise them for a full bibliography.\n- Series pages are Kindle series pages. Books that Amazon does not link into the series page cannot be discovered from that page.\n- Amazon's markup varies by marketplace and over time. The actor prefers embedded JSON and retries fresh sessions before falling back, but no scraper can guarantee every field on every page forever.\n- Data is public Amazon catalogue information. Use it for research, price monitoring, catalogue enrichment and similar lawful purposes.\n\n## FAQ\n\n**Do I need a proxy or cookies?** No. The actor works with no proxy and no Amazon account. An optional proxy override is available for users who already have one.\n\n**Can I get every book by an author?** Yes, author mode pages through the author store's complete catalogue. Use `maxItems` to cap the run.\n\n**Can I filter Kindle deals only?** Yes. Set `format` to `kindle` in deals mode.\n\n**Why is a price missing on some rows?** Amazon did not show a public price for that listing. The field is omitted instead of returning zero.\n\n**How do I get BSR and page count on search results?** Turn on `includeDetails`. It costs one extra request per book.\n\n**Does it work outside the US?** Yes. Pick any of the 21 supported marketplaces and a delivery country.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "amazon-books-scraper",
      "title": "Amazon Books Intelligence: Authors, Series & Kindle Deals",
      "description": "Read Amazon book search, detail pages, complete author catalogues, series reading order and Kindle/book deals across 21 marketplaces. Rows carry ASIN, contributors, format, price, rating, reviews, series position, cover and canonical URL, with optional publisher, ISBN, BSR and description enrichment.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Amazon Books Intelligence: Authors, Series & Kindle Deals\n\nAmazon's book catalogue is bigger than a keyword search box. This actor reads the book-specific surfaces that generic product scrapers skip:\n\n- **Search** the Books, Kindle and Audible catalogues and get clean, filterable rows.\n- **Read an author's complete catalogue** from an author store, including books that never surface in a keyword search, with the author bio, photo and total catalogue size.\n- **Follow a series** in reading order with positions, publication dates, contributors and Goodreads ratings.\n- **Collect Kindle and book deals** with the deal price, list price, discount and deal badge.\n- **Enrich any row** with its detail page for publisher, publication date, page count, ISBN, file size, best-seller rank and full description.\n\nEverything is public and cookieless. No Amazon login, cookie, API key or proxy setup is needed.\n\n## Modes\n\n| Mode | What it returns | Required input |\n|---|---|---|\n| `search` | One row per book from Amazon Books / Kindle / Audible search results | `searchQueries` |\n| `details` | One row per ASIN with the full detail page fields | `asins` or `bookUrls` |\n| `author` | Every book in an author's catalogue, newest first or by any sort | `authorIds` |\n| `series` | Every book in a series, in reading order | `asins` or `bookUrls` (series ASINs) |\n| `deals` | Today's Kindle and book deals, one row per deal | none |\n\n## Input examples\n\n### Search books\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"cozy fantasy\", \"brandon sanderson\"],\n  \"marketplace\": \"amazon.com\",\n  \"format\": \"kindle\",\n  \"searchSort\": \"review\",\n  \"minRating\": 4,\n  \"maxItems\": 50\n}\n```\n\n### Author catalogue\n\n```json\n{\n  \"mode\": \"author\",\n  \"authorIds\": [\"B001IGFHW6\"],\n  \"authorSort\": \"newest\",\n  \"authorLanguage\": \"English\",\n  \"maxItems\": 200\n}\n```\n\n### Series reading order\n\n```json\n{\n  \"mode\": \"series\",\n  \"asins\": [\"B0F11YD12X\"],\n  \"maxItems\": 50\n}\n```\n\n### Book details with enrichment\n\n```json\n{\n  \"mode\": \"details\",\n  \"asins\": [\"B0BPNB19CL\", \"059035342X\"],\n  \"bookUrls\": [\"https://www.amazon.com/dp/1408856778\"],\n  \"includeDetails\": true\n}\n```\n\n### Kindle and book deals\n\n```json\n{\n  \"mode\": \"deals\",\n  \"format\": \"kindle\",\n  \"minDiscountPercent\": 50,\n  \"maxItems\": 100\n}\n```\n\n## What each row contains\n\nEvery row includes:\n\n- `recordType`: `bookSearch`, `bookDetail`, `authorBook`, `seriesBook` or `bookDeal`\n- `asin`, `title`, `sourceUrl`, `marketplace`, `currency`, `scrapedAt`\n- `authors`, `primaryAuthor`, `contributors` with roles and profile links\n- `format`, `formatGroup`, `formats` (when the page lists other bindings)\n- `price`, `listPrice` as `{value, currency, display}` objects\n- `rating`, `reviewCount`, `savingsPercent`, `savingsAmount`\n- `seriesTitle`, `seriesPosition`, `seriesTotal`, `seriesUrl`\n- `coverImageUrl`, `imageUrls`\n- `sponsored`, `bestSeller`, `editorsPick`, `amazonsChoice`, `kindleUnlimited`\n- `page`, `positionOnPage` for search results\n\nDetail-enriched rows add:\n\n- `publisher`, `publicationDate`, `publicationDateText`, `language`\n- `pageCount`, `isbn10`, `isbn13`, `fileSize`, `dimensions`, `readingAge`\n- `bestSellersRanks` (all ranks shown) and `bestSellersRankPrimary`\n- `description`, `availability`\n\nAuthor rows add:\n\n- `author`: `{authorId, authorName, authorBio, authorPhotoUrl, authorBookCount, authorUrl}`\n\nDeal rows add:\n\n- `dealCollection`, `dealRefTag`, `dealBadge`, `dealMessage`\n\nEmpty fields are omitted. A missing field never becomes `null`, `\"\"` or a sentinel value.\n\n## How it works\n\n1. Opens a fresh Amazon session with a mobile browser profile and seeds the requested display currency.\n2. Reads the requested surface: the mobile search endpoint, a product page, an author store and its product-grid API, the series `seriesAsinList` endpoint, or the book-deals page.\n3. Parses the embedded JSON first and falls back to the rendered HTML.\n4. Rotates the session, backs off and retries when Amazon returns a bot-check or a 429/5xx page.\n5. Pushes one clean record per book and stops at `maxItems`.\n\nThe author mode reads the complete catalogue through Amazon's own paginated product grid, not just the first visible shelf. Series mode walks every `seriesAsinList` page until no new ASINs arrive.\n\n## Input reference\n\n| Field | Type | Notes |\n|---|---|---|\n| `mode` | select | `search`, `details`, `author`, `series`, `deals` |\n| `searchQueries` | string list | Search mode queries |\n| `asins` | string list | Book ASINs (details) or series ASINs (series) |\n| `bookUrls` | string list | Full Amazon URLs; ASINs are extracted |\n| `authorIds` | string list | Author IDs or author-store URLs |\n| `marketplace` | select | 21 Amazon marketplaces |\n| `currency` | select | Display currency; `auto` follows the marketplace |\n| `deliveryCountry` | select | Ship-to country for price/availability |\n| `deliveryPostalCode` | text | Optional postal/ZIP code for the delivery country |\n| `searchSort` | select | relevance, price, review, newest, bestseller |\n| `authorSort` | select | popularity, price, review, newest, most reviews |\n| `format` | select | all, kindle, paperback, hardcover, audiobook, mass market, board book |\n| `authorLanguage` | select | Author-catalogue language filter |\n| `minPrice` / `maxPrice` | number | Price bounds |\n| `minRating` / `maxRating` | number | Rating bounds |\n| `minDiscountPercent` | number | Deal discount floor |\n| `publishedAfter` / `publishedBefore` | date | ISO date bounds; unknown dates pass |\n| `titleContains` | text | Substring filter |\n| `excludeKeywords` | text | Comma-separated title exclusions |\n| `includeSponsored` | boolean | Keep sponsored search placements |\n| `includeDetails` | boolean | Fetch every book's detail page |\n| `maxItems` | integer | 1-1000, default 50 |\n| `maxPages` | integer | 1-50, default 10 |\n| `proxyConfiguration` | object | Optional Apify Proxy override |\n\n\n## Defaults\n\n| Field | Default |\n|---|---|\n| `mode` | `search` |\n| `marketplace` | `amazon.com` |\n| `currency` | `auto` |\n| `deliveryCountry` | `auto` |\n| `searchSort` | `relevance` |\n| `authorSort` | `popularity` |\n| `format` | `all` |\n| `authorLanguage` | `All Languages` |\n| `includeSponsored` | `true` |\n| `includeDetails` | `false` |\n| `maxItems` | `50` (prefill `3`) |\n| `maxPages` | `10` (prefill `1`) |\n\n## Limits and notes\n\n- Amazon shows different prices by delivery location. Set `deliveryCountry` (and optionally `deliveryPostalCode`) when you need a specific store's price. The actor still returns data without it.\n- Search result cards do not expose every detail field. Turn on `includeDetails` when you need publisher, page count, ISBN, BSR or the full description.\n- A few books have no public price (pre-orders, third-party-only listings, unavailable titles). The `price` field is omitted rather than invented.\n- Author catalogues can contain hundreds of editions. `maxItems` and `maxPages` keep a run bounded; raise them for a full bibliography.\n- Series pages are Kindle series pages. Books that Amazon does not link into the series page cannot be discovered from that page.\n- Amazon's markup varies by marketplace and over time. The actor prefers embedded JSON and retries fresh sessions before falling back, but no scraper can guarantee every field on every page forever.\n- Data is public Amazon catalogue information. Use it for research, price monitoring, catalogue enrichment and similar lawful purposes.\n\n## FAQ\n\n**Do I need a proxy or cookies?** No. The actor works with no proxy and no Amazon account. An optional proxy override is available for users who already have one.\n\n**Can I get every book by an author?** Yes, author mode pages through the author store's complete catalogue. Use `maxItems` to cap the run.\n\n**Can I filter Kindle deals only?** Yes. Set `format` to `kindle` in deals mode.\n\n**Why is a price missing on some rows?** Amazon did not show a public price for that listing. The field is omitted instead of returning zero.\n\n**How do I get BSR and page count on search results?** Turn on `includeDetails`. It costs one extra request per book.\n\n**Does it work outside the US?** Yes. Pick any of the 21 supported marketplaces and a delivery country.\n",
      "input": {
        "title": "Amazon Books Intelligence Input",
        "description": "Search Amazon Books, fetch book details, crawl an author's catalogue, read a series in order, or collect Kindle/book deals. All data is public and cookieless.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to collect.",
            "editor": "select",
            "enum": [
              "search",
              "details",
              "author",
              "series",
              "deals"
            ],
            "enumTitles": [
              "Search books by keyword",
              "Book details by ASIN or URL",
              "Author catalogue (all books)",
              "Book series in reading order",
              "Kindle and book deals"
            ],
            "default": "search",
            "prefill": "search"
          },
          "searchQueries": {
            "title": "Search queries (mode=search)",
            "type": "array",
            "description": "One or more Amazon Books search queries, e.g. `harry potter`, `brandon sanderson`, `cozy fantasy`.",
            "editor": "stringList",
            "default": [],
            "prefill": [
              "harry potter"
            ]
          },
          "asins": {
            "title": "ASINs (mode=details / series)",
            "type": "array",
            "description": "Amazon ASINs. In details mode each ASIN is a book; in series mode each ASIN is a series page ASIN. Bare ASINs or full Amazon URLs are accepted.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "bookUrls": {
            "title": "Book or series URLs (mode=details / series)",
            "type": "array",
            "description": "Full Amazon book or series URLs. ASINs are extracted automatically.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "authorIds": {
            "title": "Author IDs or store URLs (mode=author)",
            "type": "array",
            "description": "Amazon author IDs (e.g. `B001IGFHW6`) or author-store URLs such as `https://www.amazon.com/stores/author/B001IGFHW6`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "marketplace": {
            "title": "Amazon marketplace",
            "type": "string",
            "description": "Amazon site to read. Prices and availability follow the site plus the delivery setting.",
            "editor": "select",
            "enum": [
              "amazon.com",
              "amazon.co.uk",
              "amazon.de",
              "amazon.fr",
              "amazon.it",
              "amazon.es",
              "amazon.ca",
              "amazon.com.au",
              "amazon.co.jp",
              "amazon.in",
              "amazon.com.br",
              "amazon.com.mx",
              "amazon.nl",
              "amazon.com.be",
              "amazon.se",
              "amazon.pl",
              "amazon.com.tr",
              "amazon.ae",
              "amazon.sa",
              "amazon.eg",
              "amazon.sg"
            ],
            "enumTitles": [
              "United States (amazon.com)",
              "United Kingdom (amazon.co.uk)",
              "Germany (amazon.de)",
              "France (amazon.fr)",
              "Italy (amazon.it)",
              "Spain (amazon.es)",
              "Canada (amazon.ca)",
              "Australia (amazon.com.au)",
              "Japan (amazon.co.jp)",
              "India (amazon.in)",
              "Brazil (amazon.com.br)",
              "Mexico (amazon.com.mx)",
              "Netherlands (amazon.nl)",
              "Belgium (amazon.com.be)",
              "Sweden (amazon.se)",
              "Poland (amazon.pl)",
              "Turkey (amazon.com.tr)",
              "United Arab Emirates (amazon.ae)",
              "Saudi Arabia (amazon.sa)",
              "Egypt (amazon.eg)",
              "Singapore (amazon.sg)"
            ],
            "default": "amazon.com",
            "prefill": "amazon.com"
          },
          "currency": {
            "title": "Display currency",
            "type": "string",
            "description": "Currency Amazon shows on the page. `Auto` uses the marketplace currency.",
            "editor": "select",
            "enum": [
              "auto",
              "USD",
              "GBP",
              "EUR",
              "CAD",
              "AUD",
              "JPY",
              "INR",
              "BRL",
              "MXN",
              "SEK",
              "PLN",
              "TRY",
              "AED",
              "SAR",
              "EGP",
              "SGD"
            ],
            "enumTitles": [
              "Auto (marketplace currency)",
              "US dollar",
              "British pound",
              "Euro",
              "Canadian dollar",
              "Australian dollar",
              "Japanese yen",
              "Indian rupee",
              "Brazilian real",
              "Mexican peso",
              "Swedish krona",
              "Polish zloty",
              "Turkish lira",
              "UAE dirham",
              "Saudi riyal",
              "Egyptian pound",
              "Singapore dollar"
            ],
            "default": "auto",
            "prefill": "auto"
          },
          "deliveryCountry": {
            "title": "Delivery country",
            "type": "string",
            "description": "Ship-to country used for prices and availability. `Auto` leaves Amazon's detected location unchanged.",
            "editor": "select",
            "enum": [
              "auto",
              "US",
              "GB",
              "DE",
              "FR",
              "IT",
              "ES",
              "CA",
              "AU",
              "JP",
              "IN",
              "BR",
              "MX",
              "NL",
              "BE",
              "SE",
              "PL",
              "TR",
              "AE",
              "SA",
              "EG",
              "SG"
            ],
            "enumTitles": [
              "Auto (Amazon default)",
              "United States",
              "United Kingdom",
              "Germany",
              "France",
              "Italy",
              "Spain",
              "Canada",
              "Australia",
              "Japan",
              "India",
              "Brazil",
              "Mexico",
              "Netherlands",
              "Belgium",
              "Sweden",
              "Poland",
              "Turkey",
              "United Arab Emirates",
              "Saudi Arabia",
              "Egypt",
              "Singapore"
            ],
            "default": "auto",
            "prefill": "auto"
          },
          "deliveryPostalCode": {
            "title": "Delivery postal code",
            "type": "string",
            "description": "Optional ZIP/postal code for the delivery country. Leave empty to use a representative local code.",
            "editor": "textfield"
          },
          "searchSort": {
            "title": "Search sort (mode=search)",
            "type": "string",
            "description": "Result order for keyword search.",
            "editor": "select",
            "enum": [
              "relevance",
              "price-asc",
              "price-desc",
              "review",
              "newest",
              "bestseller"
            ],
            "enumTitles": [
              "Relevance",
              "Price: low to high",
              "Price: high to low",
              "Average customer review",
              "Newest publication date",
              "Bestseller rank"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "authorSort": {
            "title": "Author sort (mode=author)",
            "type": "string",
            "description": "Catalogue order for author mode.",
            "editor": "select",
            "enum": [
              "popularity",
              "price-asc",
              "price-desc",
              "review",
              "newest",
              "most-reviews"
            ],
            "enumTitles": [
              "Popularity",
              "Price: low to high",
              "Price: high to low",
              "Average customer review",
              "Newest publication date",
              "Most reviews"
            ],
            "default": "popularity",
            "prefill": "popularity"
          },
          "format": {
            "title": "Book format",
            "type": "string",
            "description": "Filter by binding. Search mode uses the Kindle/Audible storefronts for those formats and filters the rest on the result card.",
            "editor": "select",
            "enum": [
              "all",
              "kindle",
              "paperback",
              "hardcover",
              "audiobook",
              "mass-market",
              "board-book"
            ],
            "enumTitles": [
              "All formats",
              "Kindle eBook",
              "Paperback",
              "Hardcover",
              "Audiobook",
              "Mass market paperback",
              "Board book"
            ],
            "default": "all",
            "prefill": "all"
          },
          "authorLanguage": {
            "title": "Book language (mode=author)",
            "type": "string",
            "description": "Language filter on the author catalogue. Only the languages Amazon exposes for author pages are listed.",
            "editor": "select",
            "enum": [
              "All Languages",
              "Catalan",
              "Chinese (Simplified)",
              "English",
              "French",
              "German",
              "Greek",
              "Italian",
              "Japanese",
              "Portuguese",
              "Spanish"
            ],
            "enumTitles": [
              "All languages",
              "Catalan",
              "Chinese (Simplified)",
              "English",
              "French",
              "German",
              "Greek",
              "Italian",
              "Japanese",
              "Portuguese",
              "Spanish"
            ],
            "default": "All Languages",
            "prefill": "All Languages"
          },
          "minPrice": {
            "title": "Minimum price",
            "type": "number",
            "description": "Drop records priced below this amount.",
            "minimum": 0,
            "maximum": 1000000
          },
          "maxPrice": {
            "title": "Maximum price",
            "type": "number",
            "description": "Drop records priced above this amount.",
            "minimum": 0,
            "maximum": 1000000
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "number",
            "description": "Drop records rated below this value (1-5).",
            "minimum": 1,
            "maximum": 5
          },
          "maxRating": {
            "title": "Maximum rating",
            "type": "number",
            "description": "Drop records rated above this value (1-5).",
            "minimum": 1,
            "maximum": 5
          },
          "minDiscountPercent": {
            "title": "Minimum discount % (mode=deals)",
            "type": "number",
            "description": "Keep only deals at or above this discount.",
            "minimum": 0,
            "maximum": 100
          },
          "publishedAfter": {
            "title": "Published after",
            "type": "string",
            "description": "ISO date `YYYY-MM-DD`. Records without a publication date pass through.",
            "editor": "textfield"
          },
          "publishedBefore": {
            "title": "Published before",
            "type": "string",
            "description": "ISO date `YYYY-MM-DD`. Records without a publication date pass through.",
            "editor": "textfield"
          },
          "titleContains": {
            "title": "Title contains",
            "type": "string",
            "description": "Case-insensitive substring filter on the book title.",
            "editor": "textfield"
          },
          "excludeKeywords": {
            "title": "Exclude title keywords",
            "type": "string",
            "description": "Comma-separated words; records whose title contains any of them are dropped.",
            "editor": "textfield"
          },
          "includeSponsored": {
            "title": "Include sponsored results",
            "type": "boolean",
            "description": "Keep Amazon sponsored search placements in search mode.",
            "default": true,
            "prefill": true
          },
          "includeDetails": {
            "title": "Enrich with detail pages",
            "type": "boolean",
            "description": "Fetch each book's detail page for publisher, page count, ISBN, BSR and description. Slower and uses more requests.",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 1000,
            "default": 50,
            "prefill": 3
          },
          "maxPages": {
            "title": "Max pages",
            "type": "integer",
            "description": "Maximum result/catalogue pages to read per query or author.",
            "minimum": 1,
            "maximum": 50,
            "default": 10,
            "prefill": 1
          },
          "proxyConfiguration": {
            "title": "Proxy configuration (optional)",
            "type": "object",
            "description": "Optional Apify Proxy override. The actor works without a proxy and selects its own retry strategy automatically.",
            "editor": "proxy"
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Amazon Books Intelligence Output",
        "description": "One dataset of book records. recordType identifies the surface: bookSearch, bookDetail, authorBook, seriesBook or bookDeal. Every record has ASIN, title, authors, format, price, rating and a canonical Amazon URL; detail-enriched records add publisher, publication date, page count, ISBN, BSR and description.",
        "properties": {
          "books": {
            "type": "string",
            "title": "Amazon books",
            "description": "Dataset containing search results, book details, author catalogue rows, series books or deals.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "categories": [
        "ECOMMERCE",
        "BOOKS"
      ],
      "defaultRunOptions": {
        "build": "latest",
        "memoryMbytes": 1024,
        "timeoutSecs": 1800
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Amazon books",
              "transformation": {
                "fields": [
                  "recordType",
                  "title",
                  "asin",
                  "authors",
                  "format",
                  "price",
                  "rating",
                  "reviewCount",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {
                  "recordType": {
                    "label": "Type",
                    "format": "text"
                  },
                  "title": {
                    "label": "Title",
                    "format": "text"
                  },
                  "asin": {
                    "label": "ASIN",
                    "format": "text"
                  },
                  "authors": {
                    "label": "Authors",
                    "format": "text"
                  },
                  "format": {
                    "label": "Format",
                    "format": "text"
                  },
                  "price": {
                    "label": "Price",
                    "format": "text"
                  },
                  "rating": {
                    "label": "Rating",
                    "format": "number"
                  },
                  "reviewCount": {
                    "label": "Reviews",
                    "format": "number"
                  },
                  "sourceUrl": {
                    "label": "URL",
                    "format": "link"
                  }
                }
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.8",
    "imageDigest": "92029a58e39b888c6821e1c86646fd0596910fb10b5c3a48dc16ea305d2c60cc",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0023966666666666667
    }
  }
}