{ "data": { "id": "M0jj9oFFsaEaM4hmx", "actId": "tZkPJS2s2fzOcIRwS", "userId": "IYgBDiXtHOijAaUel", "startedAt": "2026-11-11T11:11:16.593Z", "finishedAt": "2026-11-11T11:11:54.285Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 37607, "runTimeSecs": 37.607, "computeUnits": 0.041785555555555555, "imageSizeBytes": 1217661440 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY", "exitCode": 0, "inputSchema": "{\n \"title\": \"Amazon Seller & Shop Scraper Input\",\n \"description\": \"Scrape Amazon third-party seller profiles and storefront catalogs. Provide one or more seller IDs directly, and/or product URLs to auto-derive the seller ID from the buy-box seller link.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"PROFILE fetches only the seller profile page (including recent individual feedback entries when enabled). PRODUCTS fetches only the seller's storefront catalog. BOTH fetches both for every resolved seller.\",\n \"editor\": \"select\",\n \"enum\": [\n \"PROFILE\",\n \"PRODUCTS\",\n \"BOTH\"\n ],\n \"enumTitles\": [\n \"Seller profile only\",\n \"Seller storefront products only\",\n \"Both profile and products\"\n ],\n \"default\": \"BOTH\",\n \"prefill\": \"BOTH\"\n },\n \"sellerIds\": {\n \"title\": \"Seller IDs\",\n \"type\": \"array\",\n \"description\": \"Amazon seller/merchant IDs (e.g. A294P4X9EWVXLJ). Accepts bare IDs or IDs embedded in a seller/storefront URL.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n },\n \"example\": [\n \"A294P4X9EWVXLJ\"\n ],\n \"default\": [],\n \"prefill\": [\n \"A294P4X9EWVXLJ\"\n ]\n },\n \"productUrls\": {\n \"title\": \"Product URLs\",\n \"type\": \"array\",\n \"description\": \"Amazon product page URLs (e.g. https://www.amazon.com/dp/ASIN). The seller ID is auto-derived from each product's buy-box \\\"sold by\\\" seller link.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n },\n \"example\": [\n \"https://www.amazon.com/dp/B0BTYCRJSS\"\n ],\n \"default\": [],\n \"prefill\": []\n },\n \"marketplace\": {\n \"title\": \"Marketplace\",\n \"type\": \"string\",\n \"description\": \"Amazon marketplace/domain to scrape sellers on. Overrides the domain inferred from productUrls when both are provided.\",\n \"editor\": \"select\",\n \"enum\": [\n \"US\",\n \"CA\",\n \"MX\",\n \"BR\",\n \"IE\",\n \"ES\",\n \"GB\",\n \"FR\",\n \"BE\",\n \"NL\",\n \"DE\",\n \"IT\",\n \"SE\",\n \"ZA\",\n \"PL\",\n \"EG\",\n \"TR\",\n \"SA\",\n \"AE\",\n \"IN\",\n \"SG\",\n \"AU\",\n \"JP\"\n ],\n \"enumTitles\": [\n \"United States (amazon.com)\",\n \"Canada (amazon.ca)\",\n \"Mexico (amazon.com.mx)\",\n \"Brazil (amazon.com.br)\",\n \"Ireland (amazon.ie)\",\n \"Spain (amazon.es)\",\n \"United Kingdom (amazon.co.uk)\",\n \"France (amazon.fr)\",\n \"Belgium (amazon.com.be)\",\n \"Netherlands (amazon.nl)\",\n \"Germany (amazon.de)\",\n \"Italy (amazon.it)\",\n \"Sweden (amazon.se)\",\n \"South Africa (amazon.co.za)\",\n \"Poland (amazon.pl)\",\n \"Egypt (amazon.eg)\",\n \"Turkey (amazon.com.tr)\",\n \"Saudi Arabia (amazon.sa)\",\n \"United Arab Emirates (amazon.ae)\",\n \"India (amazon.in)\",\n \"Singapore (amazon.sg)\",\n \"Australia (amazon.com.au)\",\n \"Japan (amazon.co.jp)\"\n ],\n \"default\": \"US\",\n \"prefill\": \"US\"\n },\n \"proxyCountry\": {\n \"title\": \"Proxy Country\",\n \"type\": \"string\",\n \"description\": \"Optional geo-targeting override. AUTO follows the selected marketplace and needs no setup; the actor picks a working connection automatically.\",\n \"editor\": \"select\",\n \"enum\": [\n \"AUTO\",\n \"US\",\n \"CA\",\n \"MX\",\n \"BR\",\n \"IE\",\n \"ES\",\n \"GB\",\n \"FR\",\n \"BE\",\n \"NL\",\n \"DE\",\n \"IT\",\n \"SE\",\n \"ZA\",\n \"PL\",\n \"EG\",\n \"TR\",\n \"SA\",\n \"AE\",\n \"IN\",\n \"SG\",\n \"AU\",\n \"JP\"\n ],\n \"enumTitles\": [\n \"Auto (based on marketplace)\",\n \"United States\",\n \"Canada\",\n \"Mexico\",\n \"Brazil\",\n \"Ireland\",\n \"Spain\",\n \"United Kingdom\",\n \"France\",\n \"Belgium\",\n \"Netherlands\",\n \"Germany\",\n \"Italy\",\n \"Sweden\",\n \"South Africa\",\n \"Poland\",\n \"Egypt\",\n \"Turkey\",\n \"Saudi Arabia\",\n \"United Arab Emirates\",\n \"India\",\n \"Singapore\",\n \"Australia\",\n \"Japan\"\n ],\n \"default\": \"AUTO\",\n \"prefill\": \"AUTO\"\n },\n \"maxProductPages\": {\n \"title\": \"Max Storefront Pages Per Seller\",\n \"type\": \"integer\",\n \"description\": \"Maximum number of /s?me= storefront pages to fetch per seller (mode=PRODUCTS or BOTH). Each page holds up to ~16 products; Amazon stops pagination at the seller's own result count.\",\n \"sectionCaption\": \"Storefront catalog\",\n \"sectionDescription\": \"Controls the storefront product fetch. These fields apply only in PRODUCTS or BOTH mode.\",\n \"minimum\": 1,\n \"maximum\": 100,\n \"default\": 3,\n \"prefill\": 1\n },\n \"maxProductsPerSeller\": {\n \"title\": \"Max Products Per Seller\",\n \"type\": \"integer\",\n \"description\": \"Hard cap on product records emitted per seller, applied in addition to Max Storefront Pages. (mode=PRODUCTS or BOTH)\",\n \"minimum\": 1,\n \"maximum\": 1000,\n \"default\": 200,\n \"prefill\": 16\n },\n \"categoryFilter\": {\n \"title\": \"Category / Refinement Filter\",\n \"type\": \"string\",\n \"editor\": \"textfield\",\n \"description\": \"Optional. Narrow the storefront to one category or facet by pasting a refinement token (e.g. n:172282) or a full Amazon facet URL from the storefrontFacets record. Leave blank for the full storefront. (mode=PRODUCTS or BOTH)\",\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"sortBy\": {\n \"title\": \"Storefront Sort Order\",\n \"type\": \"string\",\n \"description\": \"Sort order for the seller's storefront catalog (mode=PRODUCTS or BOTH), matching Amazon's own storefront \\\"Sort by\\\" dropdown. Leave blank for Amazon's default (Featured).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"relevanceblender\",\n \"price-asc-rank\",\n \"price-desc-rank\",\n \"review-rank\",\n \"date-desc-rank\",\n \"exact-aware-popularity-rank\"\n ],\n \"enumTitles\": [\n \"Default (Featured)\",\n \"Featured\",\n \"Price: Low to High\",\n \"Price: High to Low\",\n \"Avg. Customer Review\",\n \"Newest Arrivals\",\n \"Best Sellers\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"includeBusinessDetails\": {\n \"title\": \"Include Business Details\",\n \"type\": \"boolean\",\n \"description\": \"If true, includes the seller's publicly-displayed legal business name, business address, and customer-service phone number (data Amazon itself shows on the public seller profile page -- not customer-level personal data).\",\n \"sectionCaption\": \"Profile details\",\n \"sectionDescription\": \"Controls the seller profile record. These fields apply only in PROFILE or BOTH mode.\",\n \"default\": true,\n \"prefill\": true\n },\n \"includeFeedbackEntries\": {\n \"title\": \"Include Individual Feedback Entries\",\n \"type\": \"boolean\",\n \"description\": \"Include the seller's recent individual feedback entries (star rating, text, rater, date) in each seller profile record, when Amazon displays them.\",\n \"default\": true,\n \"prefill\": true\n },\n \"maxFeedbackEntries\": {\n \"title\": \"Max Feedback Entries Per Seller\",\n \"type\": \"integer\",\n \"description\": \"Maximum individual feedback entries to include per seller (Amazon returns 5 per page). Applies when Include Individual Feedback Entries is on.\",\n \"minimum\": 1,\n \"maximum\": 200,\n \"default\": 20,\n \"prefill\": 5\n },\n \"feedbackRating\": {\n \"title\": \"Feedback Star Filter\",\n \"type\": \"string\",\n \"description\": \"Only include feedback entries with this exact star rating. 'All stars' returns every rating.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"5\",\n \"4\",\n \"3\",\n \"2\",\n \"1\"\n ],\n \"enumTitles\": [\n \"All stars\",\n \"5 stars only\",\n \"4 stars only\",\n \"3 stars only\",\n \"2 stars only\",\n \"1 star only\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n },\n \"feedbackPeriod\": {\n \"title\": \"Feedback Period\",\n \"type\": \"string\",\n \"description\": \"Time window Amazon applies to the individual feedback entries and the profile rating summary.\",\n \"editor\": \"select\",\n \"enum\": [\n \"30 days\",\n \"90 days\",\n \"12 months\",\n \"lifetime\"\n ],\n \"enumTitles\": [\n \"Last 30 days\",\n \"Last 90 days\",\n \"Last 12 months\",\n \"Lifetime\"\n ],\n \"default\": \"12 months\",\n \"prefill\": \"12 months\"\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# Amazon Third-Party Seller Profile & Storefront Catalog\r\n\r\nEvery third-party seller on Amazon has a public profile page and a storefront of their own listings. This actor turns both into structured records — the seller's business identity, rating history and recent individual feedback from the profile, and every product currently listed in their storefront catalog. No login, cookies, or proxy setup required.\r\n\r\n## What this actor does\r\n\r\n- **Three modes:** `PROFILE` (seller profile + feedback), `PRODUCTS` (storefront catalog), `BOTH` (default)\r\n- **Two input paths:** supply seller IDs directly, or supply product URLs and the actor auto-derives the seller ID from each product's buy-box \"sold by\" link\r\n- **Seller profile:** name, logo, overall stars, positive-feedback percentage, and 30-day / 90-day / 12-month / lifetime rating windows with counts\r\n- **Feedback histogram:** percentage breakdown across 5/4/3/2/1 stars\r\n- **Individual feedback entries:** recent feedback rating, text, rater, date, and the seller's own reply when Amazon displays one — filterable by exact star rating and time period\r\n- **Public business data:** legal business name, business address, and customer-service phone number — data Amazon itself displays publicly on the seller profile page (toggle off with `includeBusinessDetails`)\r\n- **Storefront catalog:** reuses the standard Amazon search-result card schema (title, price, rating, image, badges) for every product in the seller's shop\r\n- **Category narrowing:** apply any category/facet from the seller's own refinement rail (`categoryFilter`)\r\n- **Sort + pagination:** Amazon's six storefront sort orders, up to 100 pages (the seller's own result count is the real limit), with a separate per-seller product cap\r\n- **23 Amazon marketplaces supported**\r\n- **Empty fields are omitted** — no null placeholders, no fabricated data\r\n\r\n## Output per seller profile record (`recordType: \"sellerProfile\"`)\r\n\r\n- `sellerId`, `sellerName`, `sellerLogo`, `profileUrl`, `storefrontUrl`, `sourceUrl`\r\n (same URL as `profileUrl`)\r\n- `starRating` — overall star rating shown in the page header\r\n- `positivePercent12m`, `ratingsCount12m` — 12-month positive-feedback percent and count (when shown)\r\n- `positivePercentWindow`, `positivePercent`, `positivePercentRatingsCount` — the exact window Amazon's own page header currently displays\r\n- `feedbackWindows[]` — `{window, starRating, ratingsCount}` for each of 30 days / 90 days / 12 months / lifetime that Amazon actually shows data for\r\n- `feedbackHistogram` — `{\"5\": {percent}, \"4\": {percent}, ...}`\r\n- `feedbackEntries[]` — recent individual feedback, newest first:\r\n `{rating, text, dateText, rater, raterProfileUrl?, raterAvatarUrl?, wasSuppressed?,\r\n suppressReason?, hasSellerResponse?, responseText?}`. Amazon returns 5 entries per page;\r\n the actor merges the profile page's server-rendered entries with further pages from the\r\n profile's own feedback endpoint, deduped by rating/text/date/rater.\r\n- `feedbackEntriesCount` — number of entries included\r\n- `feedbackPeriod`, `feedbackRating` — the filters used for the entries\r\n- `aboutText` — the seller's \"About\" description\r\n- `phone` — customer-service phone number (public, `includeBusinessDetails=true`)\r\n- `businessName`, `businessAddress` — public legal business identity\r\n (`includeBusinessDetails=true`). For the common 5-line Western format, `businessAddress` is\r\n `{street, city, state, zip, country}`; for addresses that don't fit that exact 5-line shape,\r\n `businessAddress` is instead `{addressLines: [...]}` — the real, ordered address lines exactly\r\n as Amazon renders them, never force-fit into the wrong field\r\n- `returnRefundPolicyText`, `shippingPolicyText`, `privacyPolicyText` — the seller's own\r\n policy text, when Amazon's page renders one\r\n- `scrapedAt`\r\n\r\n## Output per seller product record (`recordType: \"sellerProduct\"`)\r\n\r\n- `asin`, `sellerId`, `title`, `url`, `sourceUrl` (same URL as `url`)\r\n- `price {value, currency, display}`, `listPrice`\r\n- `stars`, `reviewsCount`\r\n- `thumbnailImage`\r\n- `prime`, `sponsored`, `resultType` (`ORGANIC`/`SPONSORED`), `badge`\r\n- `boughtInPastMonth`\r\n- `position {page, positionOnPage, globalPosition}`\r\n- `scrapedAt`\r\n\r\n## Output per storefront facets record (`recordType: \"storefrontFacets\"`)\r\n\r\nOne record per seller with products (mode `PRODUCTS`/`BOTH`), built from the storefront's own\r\nrefinement rail and sort dropdown — lets you discover what departments/filters and sort orders\r\nexist for a seller's catalog before deciding what to request.\r\n\r\n- `sellerId`, `storefrontUrl`, `sourceUrl` (same URL as `storefrontUrl`)\r\n- `facets[]` — `{groupName, label, url, selected, refinementParameter?}` from the\r\n storefront's `#s-refinements` rail (Department, Delivery Day, Free Shipping, etc.).\r\n `refinementParameter` is the exact `rh` token `categoryFilter` accepts.\r\n- `sortOptions[]` — `{value, label, selected}` from the storefront's own \"Sort by\" dropdown —\r\n `value` is the exact string the `sortBy` input accepts\r\n- `pagesRequested`, `pagesFetched` — how many storefront pages were fetched vs.\r\n `maxProductPages`. A short fetch is never silently indistinguishable from a genuinely\r\n small storefront: `pagesStoppedReason` explains it (`BLOCKED`, `NO_MORE_RESULTS`,\r\n `MAX_PRODUCTS`, `UNEXPECTED_ERROR`)\r\n- `scrapedAt`\r\n\r\n## Output per error/terminal record (`recordType: \"sellerError\"`)\r\n\r\nEmitted instead of a normal record when a seller/page could not be resolved\r\n(not found, blocked, CAPTCHA, etc.) — the actor never silently returns zero\r\nitems for a requested seller without explaining why.\r\n\r\n- `sellerId`, `sourceUrl`, `pageClassification` (e.g. `NOT_FOUND`, `CAPTCHA`, `DOG_PAGE_503`), `scrapedAt`\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `BOTH` | `PROFILE` / `PRODUCTS` / `BOTH` |\r\n| `sellerIds` | array | – | Seller/merchant IDs or seller/storefront URLs |\r\n| `productUrls` | array | – | Product URLs to derive seller IDs from (buy-box seller link) |\r\n| `marketplace` | string | `US` | Amazon marketplace/domain (23 supported) |\r\n| `maxProductPages` | int | `3` | Max storefront pages per seller, ~16 products/page (1-100) |\r\n| `maxProductsPerSeller` | int | `200` | Hard cap on product records per seller |\r\n| `categoryFilter` | string | – | Optional `rh` refinement token or full Amazon facet URL from `storefrontFacets` |\r\n| `includeBusinessDetails` | bool | `true` | Include public business name/address/phone |\r\n| `includeFeedbackEntries` | bool | `true` | Include recent individual feedback entries |\r\n| `maxFeedbackEntries` | int | `20` | Max individual feedback entries per seller |\r\n| `feedbackRating` | string | `all` | Exact star filter: `all`, `5`, `4`, `3`, `2`, `1` |\r\n| `feedbackPeriod` | string | `12 months` | `30 days` / `90 days` / `12 months` / `lifetime` |\r\n| `sortBy` | string | (default/Featured) | Storefront sort order matching Amazon's own dropdown |\r\n| `proxyCountry` | string | `AUTO` | Optional geo override; `AUTO` follows the marketplace |\r\n\r\nAt least one of `sellerIds` or `productUrls` is required.\r\n\r\n### Example: look up two sellers directly\r\n\r\n```json\r\n{\r\n \"mode\": \"BOTH\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\", \"A35BKAA6VXTYCT\"],\r\n \"maxProductPages\": 2,\r\n \"maxFeedbackEntries\": 10\r\n}\r\n```\r\n\r\n### Example: derive the seller from a product page\r\n\r\n```json\r\n{\r\n \"mode\": \"PROFILE\",\r\n \"productUrls\": [\"https://www.amazon.com/dp/B0BTYCRJSS\"]\r\n}\r\n```\r\n\r\n### Example: one storefront category, price ascending, UK marketplace\r\n\r\n```json\r\n{\r\n \"mode\": \"PRODUCTS\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\"],\r\n \"marketplace\": \"GB\",\r\n \"categoryFilter\": \"n:172282\",\r\n \"sortBy\": \"price-asc-rank\",\r\n \"maxProductPages\": 5,\r\n \"maxProductsPerSeller\": 80\r\n}\r\n```\r\n\r\n### Example: recent critical feedback only\r\n\r\n```json\r\n{\r\n \"mode\": \"PROFILE\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\"],\r\n \"includeFeedbackEntries\": true,\r\n \"feedbackRating\": \"1\",\r\n \"feedbackPeriod\": \"90 days\",\r\n \"maxFeedbackEntries\": 20\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Lead generation** — build a list of active third-party sellers with public business\r\n name/address/phone for outreach\r\n- **Competitor research** — monitor a competing seller's full storefront catalog, categories,\r\n pricing and sort order\r\n- **Seller due-diligence** — check a seller's rating history across multiple feedback windows\r\n and read their recent individual feedback\r\n- **Brand protection** — pull recent critical feedback and any seller replies\r\n- **Marketplace research** — compare seller reputations across categories and marketplaces\r\n- **Supply-chain verification** — confirm a seller's legal business identity before sourcing\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with Amazon?**\r\nNo. This is an independent third-party actor that reads Amazon's own public seller profile and\r\nstorefront pages — no API keys, cookies, or login required.\r\n\r\n**Do I need to configure a proxy?**\r\nNo. The actor chooses a working connection automatically and needs no proxy setup from you. Leave\r\n`proxyCountry` on `AUTO` unless you specifically need another marketplace's exit country.\r\n\r\n**Are individual feedback comments included?**\r\nYes. The public profile page renders recent individual feedback entries, and the actor also asks\r\nthe profile's own feedback endpoint for more pages. Each entry includes the star rating, the\r\nfeedback text (when the buyer wrote one), the rater display name, the date Amazon shows, and the\r\nseller's reply when present. Filters let you request only a specific star rating and time window.\r\n\r\n**Why are feedback dates not ISO-formatted?**\r\nAmazon serves the date exactly as displayed for that marketplace (\"November 11, 2026\",\r\n\"9. November 2026\", \"22 octobre 2026\"). The actor keeps that display string in `dateText` rather\r\nthan inventing a machine date it cannot verify.\r\n\r\n**Is the business name/address/phone customer personal data?**\r\nNo. This is the seller's own public business identity that Amazon displays on every\r\nseller's public profile page, distinct from any Amazon customer's personal data. You can disable it\r\nwith `includeBusinessDetails: false`.\r\n\r\n**Why do some sellers have fewer feedback windows or no entries?**\r\nAmazon only shows a feedback window when the seller has ratings data for that window, and only\r\nrenders entries when feedback exists. Amazon Resale, for example, has a profile but no feedback\r\nhistogram or entries. The actor reports exactly what Amazon displays, never a fabricated shape.\r\n\r\n**Why is a seller record sometimes missing instead of empty?**\r\nIf a seller ID can't be resolved (not found, blocked, CAPTCHA), the actor emits an explicit\r\nerror/terminal record (`recordType: \"sellerError\"`) with a `pageClassification` explaining why,\r\nrather than silently returning nothing.\r\n\r\n**How many products does the storefront catalog return?**\r\nUp to `maxProductPages` × ~16 products, further capped by `maxProductsPerSeller`. That is exactly\r\nwhat Amazon's own storefront pagination exposes for that seller, not a fixed/guaranteed count.\r\n\r\n**Does this work on every Amazon marketplace?**\r\nYes — all 23 supported marketplaces use the same profile/storefront/feedback surfaces. Non-US\r\nmarketplaces can occasionally route through a slower connection; the actor retries automatically.\r\n\r\n**Why does `profileUrl`/`storefrontUrl` return an error in a plain script check?**\r\nAmazon blocks some non-browser requests to `/sp?seller=...` and `/s?me=...` with a `503`, even\r\nthough the exact same URL loads fine in a real browser (or via this actor). `productUrl`\r\n(`/dp/ASIN`) and media/thumbnail URLs are not behind this same block and return `200` from a plain\r\nclient.\r\n\r\n**Is `sortBy` guaranteed across every storefront page?**\r\nAmazon's own storefront reliably honors a non-default `sortBy` on page 1. For later pages the\r\nactor carries the sort session forward using Amazon's own \"next page\" link and query-id, but\r\nAmazon does not guarantee the same strict order past page 1 for every sort value — treat page 1 as\r\nthe authoritative sorted sample if you need a strict global order.\r\n\r\n## Limitations\r\n\r\n- **Member-since date and seller response time** are not present on the public seller profile\r\n pages this actor reads, so they are not emitted.\r\n- **Positive / neutral / negative feedback counts** are not displayed separately; Amazon exposes\r\n the star histogram and positive-feedback percentage instead.\r\n- **Storefront depth:** Amazon stops at the seller's own result count (for example 973 results =\r\n 61 pages); `maxProductPages` defaults to 3 and can be raised to 100. Use `categoryFilter` to\r\n partition a very large catalog into narrower slices if you need a smaller, complete view.\r\n- **Feedback pagination** stops at `maxFeedbackEntries` (1–200) and follows Amazon's own\r\n `hasNextPage` signal; a seller with no feedback yields no `feedbackEntries` field.\r\n- **Seller discovery from category/search pages** is a different use case and is not part of this\r\n actor; supply seller IDs, seller URLs, or product URLs.\r\n", "actorDefinition": { "actorSpecification": 1, "name": "amazon-third-party-seller-profile-and-storefront", "title": "Amazon Third-Party Seller Profile & Storefront Catalog", "description": "Look up an Amazon third-party seller's public business details, rating history, ratings histogram and recent individual feedback entries, plus every product listed in their storefront, by seller ID or product URL.", "version": "1.0", "meta": { "templateId": "python-playwright" }, "input": { "title": "Amazon Seller & Shop Scraper Input", "description": "Scrape Amazon third-party seller profiles and storefront catalogs. Provide one or more seller IDs directly, and/or product URLs to auto-derive the seller ID from the buy-box seller link.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "PROFILE fetches only the seller profile page (including recent individual feedback entries when enabled). PRODUCTS fetches only the seller's storefront catalog. BOTH fetches both for every resolved seller.", "editor": "select", "enum": [ "PROFILE", "PRODUCTS", "BOTH" ], "enumTitles": [ "Seller profile only", "Seller storefront products only", "Both profile and products" ], "default": "BOTH", "prefill": "BOTH" }, "sellerIds": { "title": "Seller IDs", "type": "array", "description": "Amazon seller/merchant IDs (e.g. A294P4X9EWVXLJ). Accepts bare IDs or IDs embedded in a seller/storefront URL.", "editor": "stringList", "items": { "type": "string" }, "example": [ "A294P4X9EWVXLJ" ], "default": [], "prefill": [ "A294P4X9EWVXLJ" ] }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Amazon product page URLs (e.g. https://www.amazon.com/dp/ASIN). The seller ID is auto-derived from each product's buy-box \"sold by\" seller link.", "editor": "stringList", "items": { "type": "string" }, "example": [ "https://www.amazon.com/dp/B0BTYCRJSS" ], "default": [], "prefill": [] }, "marketplace": { "title": "Marketplace", "type": "string", "description": "Amazon marketplace/domain to scrape sellers on. Overrides the domain inferred from productUrls when both are provided.", "editor": "select", "enum": [ "US", "CA", "MX", "BR", "IE", "ES", "GB", "FR", "BE", "NL", "DE", "IT", "SE", "ZA", "PL", "EG", "TR", "SA", "AE", "IN", "SG", "AU", "JP" ], "enumTitles": [ "United States (amazon.com)", "Canada (amazon.ca)", "Mexico (amazon.com.mx)", "Brazil (amazon.com.br)", "Ireland (amazon.ie)", "Spain (amazon.es)", "United Kingdom (amazon.co.uk)", "France (amazon.fr)", "Belgium (amazon.com.be)", "Netherlands (amazon.nl)", "Germany (amazon.de)", "Italy (amazon.it)", "Sweden (amazon.se)", "South Africa (amazon.co.za)", "Poland (amazon.pl)", "Egypt (amazon.eg)", "Turkey (amazon.com.tr)", "Saudi Arabia (amazon.sa)", "United Arab Emirates (amazon.ae)", "India (amazon.in)", "Singapore (amazon.sg)", "Australia (amazon.com.au)", "Japan (amazon.co.jp)" ], "default": "US", "prefill": "US" }, "proxyCountry": { "title": "Proxy Country", "type": "string", "description": "Optional geo-targeting override. AUTO follows the selected marketplace and needs no setup; the actor picks a working connection automatically.", "editor": "select", "enum": [ "AUTO", "US", "CA", "MX", "BR", "IE", "ES", "GB", "FR", "BE", "NL", "DE", "IT", "SE", "ZA", "PL", "EG", "TR", "SA", "AE", "IN", "SG", "AU", "JP" ], "enumTitles": [ "Auto (based on marketplace)", "United States", "Canada", "Mexico", "Brazil", "Ireland", "Spain", "United Kingdom", "France", "Belgium", "Netherlands", "Germany", "Italy", "Sweden", "South Africa", "Poland", "Egypt", "Turkey", "Saudi Arabia", "United Arab Emirates", "India", "Singapore", "Australia", "Japan" ], "default": "AUTO", "prefill": "AUTO" }, "maxProductPages": { "title": "Max Storefront Pages Per Seller", "type": "integer", "description": "Maximum number of /s?me= storefront pages to fetch per seller (mode=PRODUCTS or BOTH). Each page holds up to ~16 products; Amazon stops pagination at the seller's own result count.", "sectionCaption": "Storefront catalog", "sectionDescription": "Controls the storefront product fetch. These fields apply only in PRODUCTS or BOTH mode.", "minimum": 1, "maximum": 100, "default": 3, "prefill": 1 }, "maxProductsPerSeller": { "title": "Max Products Per Seller", "type": "integer", "description": "Hard cap on product records emitted per seller, applied in addition to Max Storefront Pages. (mode=PRODUCTS or BOTH)", "minimum": 1, "maximum": 1000, "default": 200, "prefill": 16 }, "categoryFilter": { "title": "Category / Refinement Filter", "type": "string", "editor": "textfield", "description": "Optional. Narrow the storefront to one category or facet by pasting a refinement token (e.g. n:172282) or a full Amazon facet URL from the storefrontFacets record. Leave blank for the full storefront. (mode=PRODUCTS or BOTH)", "default": "", "prefill": "" }, "sortBy": { "title": "Storefront Sort Order", "type": "string", "description": "Sort order for the seller's storefront catalog (mode=PRODUCTS or BOTH), matching Amazon's own storefront \"Sort by\" dropdown. Leave blank for Amazon's default (Featured).", "editor": "select", "enum": [ "", "relevanceblender", "price-asc-rank", "price-desc-rank", "review-rank", "date-desc-rank", "exact-aware-popularity-rank" ], "enumTitles": [ "Default (Featured)", "Featured", "Price: Low to High", "Price: High to Low", "Avg. Customer Review", "Newest Arrivals", "Best Sellers" ], "default": "", "prefill": "" }, "includeBusinessDetails": { "title": "Include Business Details", "type": "boolean", "description": "If true, includes the seller's publicly-displayed legal business name, business address, and customer-service phone number (data Amazon itself shows on the public seller profile page -- not customer-level personal data).", "sectionCaption": "Profile details", "sectionDescription": "Controls the seller profile record. These fields apply only in PROFILE or BOTH mode.", "default": true, "prefill": true }, "includeFeedbackEntries": { "title": "Include Individual Feedback Entries", "type": "boolean", "description": "Include the seller's recent individual feedback entries (star rating, text, rater, date) in each seller profile record, when Amazon displays them.", "default": true, "prefill": true }, "maxFeedbackEntries": { "title": "Max Feedback Entries Per Seller", "type": "integer", "description": "Maximum individual feedback entries to include per seller (Amazon returns 5 per page). Applies when Include Individual Feedback Entries is on.", "minimum": 1, "maximum": 200, "default": 20, "prefill": 5 }, "feedbackRating": { "title": "Feedback Star Filter", "type": "string", "description": "Only include feedback entries with this exact star rating. 'All stars' returns every rating.", "editor": "select", "enum": [ "all", "5", "4", "3", "2", "1" ], "enumTitles": [ "All stars", "5 stars only", "4 stars only", "3 stars only", "2 stars only", "1 star only" ], "default": "all", "prefill": "all" }, "feedbackPeriod": { "title": "Feedback Period", "type": "string", "description": "Time window Amazon applies to the individual feedback entries and the profile rating summary.", "editor": "select", "enum": [ "30 days", "90 days", "12 months", "lifetime" ], "enumTitles": [ "Last 30 days", "Last 90 days", "Last 12 months", "Lifetime" ], "default": "12 months", "prefill": "12 months" } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Amazon Third-Party Seller Profile & Storefront Catalog Output", "description": "Seller profile records (logo, business name/address/phone, ratings, feedback windows, histogram, recent individual feedback entries), seller storefront product records, and one storefront-facets record per seller (refinement facets + available sort options) from Amazon.", "properties": { "records": { "type": "string", "title": "Seller & product records", "description": "Dataset containing all scraped seller profile and seller-storefront product records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "dockerfile": "../Dockerfile", "readme": "# Amazon Third-Party Seller Profile & Storefront Catalog\r\n\r\nEvery third-party seller on Amazon has a public profile page and a storefront of their own listings. This actor turns both into structured records — the seller's business identity, rating history and recent individual feedback from the profile, and every product currently listed in their storefront catalog. No login, cookies, or proxy setup required.\r\n\r\n## What this actor does\r\n\r\n- **Three modes:** `PROFILE` (seller profile + feedback), `PRODUCTS` (storefront catalog), `BOTH` (default)\r\n- **Two input paths:** supply seller IDs directly, or supply product URLs and the actor auto-derives the seller ID from each product's buy-box \"sold by\" link\r\n- **Seller profile:** name, logo, overall stars, positive-feedback percentage, and 30-day / 90-day / 12-month / lifetime rating windows with counts\r\n- **Feedback histogram:** percentage breakdown across 5/4/3/2/1 stars\r\n- **Individual feedback entries:** recent feedback rating, text, rater, date, and the seller's own reply when Amazon displays one — filterable by exact star rating and time period\r\n- **Public business data:** legal business name, business address, and customer-service phone number — data Amazon itself displays publicly on the seller profile page (toggle off with `includeBusinessDetails`)\r\n- **Storefront catalog:** reuses the standard Amazon search-result card schema (title, price, rating, image, badges) for every product in the seller's shop\r\n- **Category narrowing:** apply any category/facet from the seller's own refinement rail (`categoryFilter`)\r\n- **Sort + pagination:** Amazon's six storefront sort orders, up to 100 pages (the seller's own result count is the real limit), with a separate per-seller product cap\r\n- **23 Amazon marketplaces supported**\r\n- **Empty fields are omitted** — no null placeholders, no fabricated data\r\n\r\n## Output per seller profile record (`recordType: \"sellerProfile\"`)\r\n\r\n- `sellerId`, `sellerName`, `sellerLogo`, `profileUrl`, `storefrontUrl`, `sourceUrl`\r\n (same URL as `profileUrl`)\r\n- `starRating` — overall star rating shown in the page header\r\n- `positivePercent12m`, `ratingsCount12m` — 12-month positive-feedback percent and count (when shown)\r\n- `positivePercentWindow`, `positivePercent`, `positivePercentRatingsCount` — the exact window Amazon's own page header currently displays\r\n- `feedbackWindows[]` — `{window, starRating, ratingsCount}` for each of 30 days / 90 days / 12 months / lifetime that Amazon actually shows data for\r\n- `feedbackHistogram` — `{\"5\": {percent}, \"4\": {percent}, ...}`\r\n- `feedbackEntries[]` — recent individual feedback, newest first:\r\n `{rating, text, dateText, rater, raterProfileUrl?, raterAvatarUrl?, wasSuppressed?,\r\n suppressReason?, hasSellerResponse?, responseText?}`. Amazon returns 5 entries per page;\r\n the actor merges the profile page's server-rendered entries with further pages from the\r\n profile's own feedback endpoint, deduped by rating/text/date/rater.\r\n- `feedbackEntriesCount` — number of entries included\r\n- `feedbackPeriod`, `feedbackRating` — the filters used for the entries\r\n- `aboutText` — the seller's \"About\" description\r\n- `phone` — customer-service phone number (public, `includeBusinessDetails=true`)\r\n- `businessName`, `businessAddress` — public legal business identity\r\n (`includeBusinessDetails=true`). For the common 5-line Western format, `businessAddress` is\r\n `{street, city, state, zip, country}`; for addresses that don't fit that exact 5-line shape,\r\n `businessAddress` is instead `{addressLines: [...]}` — the real, ordered address lines exactly\r\n as Amazon renders them, never force-fit into the wrong field\r\n- `returnRefundPolicyText`, `shippingPolicyText`, `privacyPolicyText` — the seller's own\r\n policy text, when Amazon's page renders one\r\n- `scrapedAt`\r\n\r\n## Output per seller product record (`recordType: \"sellerProduct\"`)\r\n\r\n- `asin`, `sellerId`, `title`, `url`, `sourceUrl` (same URL as `url`)\r\n- `price {value, currency, display}`, `listPrice`\r\n- `stars`, `reviewsCount`\r\n- `thumbnailImage`\r\n- `prime`, `sponsored`, `resultType` (`ORGANIC`/`SPONSORED`), `badge`\r\n- `boughtInPastMonth`\r\n- `position {page, positionOnPage, globalPosition}`\r\n- `scrapedAt`\r\n\r\n## Output per storefront facets record (`recordType: \"storefrontFacets\"`)\r\n\r\nOne record per seller with products (mode `PRODUCTS`/`BOTH`), built from the storefront's own\r\nrefinement rail and sort dropdown — lets you discover what departments/filters and sort orders\r\nexist for a seller's catalog before deciding what to request.\r\n\r\n- `sellerId`, `storefrontUrl`, `sourceUrl` (same URL as `storefrontUrl`)\r\n- `facets[]` — `{groupName, label, url, selected, refinementParameter?}` from the\r\n storefront's `#s-refinements` rail (Department, Delivery Day, Free Shipping, etc.).\r\n `refinementParameter` is the exact `rh` token `categoryFilter` accepts.\r\n- `sortOptions[]` — `{value, label, selected}` from the storefront's own \"Sort by\" dropdown —\r\n `value` is the exact string the `sortBy` input accepts\r\n- `pagesRequested`, `pagesFetched` — how many storefront pages were fetched vs.\r\n `maxProductPages`. A short fetch is never silently indistinguishable from a genuinely\r\n small storefront: `pagesStoppedReason` explains it (`BLOCKED`, `NO_MORE_RESULTS`,\r\n `MAX_PRODUCTS`, `UNEXPECTED_ERROR`)\r\n- `scrapedAt`\r\n\r\n## Output per error/terminal record (`recordType: \"sellerError\"`)\r\n\r\nEmitted instead of a normal record when a seller/page could not be resolved\r\n(not found, blocked, CAPTCHA, etc.) — the actor never silently returns zero\r\nitems for a requested seller without explaining why.\r\n\r\n- `sellerId`, `sourceUrl`, `pageClassification` (e.g. `NOT_FOUND`, `CAPTCHA`, `DOG_PAGE_503`), `scrapedAt`\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `BOTH` | `PROFILE` / `PRODUCTS` / `BOTH` |\r\n| `sellerIds` | array | – | Seller/merchant IDs or seller/storefront URLs |\r\n| `productUrls` | array | – | Product URLs to derive seller IDs from (buy-box seller link) |\r\n| `marketplace` | string | `US` | Amazon marketplace/domain (23 supported) |\r\n| `maxProductPages` | int | `3` | Max storefront pages per seller, ~16 products/page (1-100) |\r\n| `maxProductsPerSeller` | int | `200` | Hard cap on product records per seller |\r\n| `categoryFilter` | string | – | Optional `rh` refinement token or full Amazon facet URL from `storefrontFacets` |\r\n| `includeBusinessDetails` | bool | `true` | Include public business name/address/phone |\r\n| `includeFeedbackEntries` | bool | `true` | Include recent individual feedback entries |\r\n| `maxFeedbackEntries` | int | `20` | Max individual feedback entries per seller |\r\n| `feedbackRating` | string | `all` | Exact star filter: `all`, `5`, `4`, `3`, `2`, `1` |\r\n| `feedbackPeriod` | string | `12 months` | `30 days` / `90 days` / `12 months` / `lifetime` |\r\n| `sortBy` | string | (default/Featured) | Storefront sort order matching Amazon's own dropdown |\r\n| `proxyCountry` | string | `AUTO` | Optional geo override; `AUTO` follows the marketplace |\r\n\r\nAt least one of `sellerIds` or `productUrls` is required.\r\n\r\n### Example: look up two sellers directly\r\n\r\n```json\r\n{\r\n \"mode\": \"BOTH\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\", \"A35BKAA6VXTYCT\"],\r\n \"maxProductPages\": 2,\r\n \"maxFeedbackEntries\": 10\r\n}\r\n```\r\n\r\n### Example: derive the seller from a product page\r\n\r\n```json\r\n{\r\n \"mode\": \"PROFILE\",\r\n \"productUrls\": [\"https://www.amazon.com/dp/B0BTYCRJSS\"]\r\n}\r\n```\r\n\r\n### Example: one storefront category, price ascending, UK marketplace\r\n\r\n```json\r\n{\r\n \"mode\": \"PRODUCTS\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\"],\r\n \"marketplace\": \"GB\",\r\n \"categoryFilter\": \"n:172282\",\r\n \"sortBy\": \"price-asc-rank\",\r\n \"maxProductPages\": 5,\r\n \"maxProductsPerSeller\": 80\r\n}\r\n```\r\n\r\n### Example: recent critical feedback only\r\n\r\n```json\r\n{\r\n \"mode\": \"PROFILE\",\r\n \"sellerIds\": [\"A294P4X9EWVXLJ\"],\r\n \"includeFeedbackEntries\": true,\r\n \"feedbackRating\": \"1\",\r\n \"feedbackPeriod\": \"90 days\",\r\n \"maxFeedbackEntries\": 20\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Lead generation** — build a list of active third-party sellers with public business\r\n name/address/phone for outreach\r\n- **Competitor research** — monitor a competing seller's full storefront catalog, categories,\r\n pricing and sort order\r\n- **Seller due-diligence** — check a seller's rating history across multiple feedback windows\r\n and read their recent individual feedback\r\n- **Brand protection** — pull recent critical feedback and any seller replies\r\n- **Marketplace research** — compare seller reputations across categories and marketplaces\r\n- **Supply-chain verification** — confirm a seller's legal business identity before sourcing\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with Amazon?**\r\nNo. This is an independent third-party actor that reads Amazon's own public seller profile and\r\nstorefront pages — no API keys, cookies, or login required.\r\n\r\n**Do I need to configure a proxy?**\r\nNo. The actor chooses a working connection automatically and needs no proxy setup from you. Leave\r\n`proxyCountry` on `AUTO` unless you specifically need another marketplace's exit country.\r\n\r\n**Are individual feedback comments included?**\r\nYes. The public profile page renders recent individual feedback entries, and the actor also asks\r\nthe profile's own feedback endpoint for more pages. Each entry includes the star rating, the\r\nfeedback text (when the buyer wrote one), the rater display name, the date Amazon shows, and the\r\nseller's reply when present. Filters let you request only a specific star rating and time window.\r\n\r\n**Why are feedback dates not ISO-formatted?**\r\nAmazon serves the date exactly as displayed for that marketplace (\"November 11, 2026\",\r\n\"9. November 2026\", \"22 octobre 2026\"). The actor keeps that display string in `dateText` rather\r\nthan inventing a machine date it cannot verify.\r\n\r\n**Is the business name/address/phone customer personal data?**\r\nNo. This is the seller's own public business identity that Amazon displays on every\r\nseller's public profile page, distinct from any Amazon customer's personal data. You can disable it\r\nwith `includeBusinessDetails: false`.\r\n\r\n**Why do some sellers have fewer feedback windows or no entries?**\r\nAmazon only shows a feedback window when the seller has ratings data for that window, and only\r\nrenders entries when feedback exists. Amazon Resale, for example, has a profile but no feedback\r\nhistogram or entries. The actor reports exactly what Amazon displays, never a fabricated shape.\r\n\r\n**Why is a seller record sometimes missing instead of empty?**\r\nIf a seller ID can't be resolved (not found, blocked, CAPTCHA), the actor emits an explicit\r\nerror/terminal record (`recordType: \"sellerError\"`) with a `pageClassification` explaining why,\r\nrather than silently returning nothing.\r\n\r\n**How many products does the storefront catalog return?**\r\nUp to `maxProductPages` × ~16 products, further capped by `maxProductsPerSeller`. That is exactly\r\nwhat Amazon's own storefront pagination exposes for that seller, not a fixed/guaranteed count.\r\n\r\n**Does this work on every Amazon marketplace?**\r\nYes — all 23 supported marketplaces use the same profile/storefront/feedback surfaces. Non-US\r\nmarketplaces can occasionally route through a slower connection; the actor retries automatically.\r\n\r\n**Why does `profileUrl`/`storefrontUrl` return an error in a plain script check?**\r\nAmazon blocks some non-browser requests to `/sp?seller=...` and `/s?me=...` with a `503`, even\r\nthough the exact same URL loads fine in a real browser (or via this actor). `productUrl`\r\n(`/dp/ASIN`) and media/thumbnail URLs are not behind this same block and return `200` from a plain\r\nclient.\r\n\r\n**Is `sortBy` guaranteed across every storefront page?**\r\nAmazon's own storefront reliably honors a non-default `sortBy` on page 1. For later pages the\r\nactor carries the sort session forward using Amazon's own \"next page\" link and query-id, but\r\nAmazon does not guarantee the same strict order past page 1 for every sort value — treat page 1 as\r\nthe authoritative sorted sample if you need a strict global order.\r\n\r\n## Limitations\r\n\r\n- **Member-since date and seller response time** are not present on the public seller profile\r\n pages this actor reads, so they are not emitted.\r\n- **Positive / neutral / negative feedback counts** are not displayed separately; Amazon exposes\r\n the star histogram and positive-feedback percentage instead.\r\n- **Storefront depth:** Amazon stops at the seller's own result count (for example 973 results =\r\n 61 pages); `maxProductPages` defaults to 3 and can be raised to 100. Use `categoryFilter` to\r\n partition a very large catalog into narrower slices if you need a smaller, complete view.\r\n- **Feedback pagination** stops at `maxFeedbackEntries` (1–200) and follows Amazon's own\r\n `hasNextPage` signal; a seller with no feedback yields no `feedbackEntries` field.\r\n- **Seller discovery from category/search pages** is a different use case and is not part of this\r\n actor; supply seller IDs, seller URLs, or product URLs.\r\n", "categories": [ "ECOMMERCE", "PRODUCTS", "LEAD_GENERATION" ], "defaultRunOptions": { "build": "latest", "memoryMbytes": 2048, "timeoutSecs": 600 }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Sellers & Products", "transformation": { "fields": [ "recordType", "sellerId", "sellerName", "title", "price", "starRating", "positivePercent12m", "feedbackEntriesCount", "scrapedAt" ] }, "display": { "component": "table", "properties": { "recordType": { "label": "Record Type", "format": "text" }, "sellerId": { "label": "Seller ID", "format": "text" }, "sellerName": { "label": "Seller Name", "format": "text" }, "title": { "label": "Product Title", "format": "text" }, "price": { "label": "Price", "format": "object" }, "starRating": { "label": "Star Rating", "format": "number" }, "positivePercent12m": { "label": "Positive % (12mo)", "format": "number" }, "feedbackEntriesCount": { "label": "Feedback Entries", "format": "number" }, "scrapedAt": { "label": "Scraped At", "format": "date" } } } } } } } }, "buildNumber": "1.0.2", "imageDigest": "ae2398a63ace8444de230d09adacdbe045cf4725d70b4763891ce66f9147aeb9", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.041785555555555555 } } }