Amazon Brand Store Page & Merchandising Crawler
Crawl an Amazon Brand Store's navigation, creative modules (images, video, CTAs), and every product link found on its pages. Resolves a brand's Store URL automatically from a product page or ASIN.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
storeUrls | array | required | Amazon Brand Store URLs, e.g. `https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633`. At least one of storeUrls / productUrls / asins is required. |
productUrls | array | optional | Amazon product (/dp/{ASIN}) URLs. The actor visits each product page, finds its "Visit the {Brand} Store" link, and crawls that store instead. |
asins | array | optional | Product ASINs on amazon.com. Same resolution behavior as productUrls. |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
storeUrls | array | required | Amazon Brand Store URLs, e.g. `https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633`. At least one of storeUrls / productUrls / asins is required. |
productUrls | array | optional | Amazon product (/dp/{ASIN}) URLs. The actor visits each product page, finds its "Visit the {Brand} Store" link, and crawls that store instead. |
asins | array | optional | Product ASINs on amazon.com. Same resolution behavior as productUrls. |
crawlSubpages | boolean | optional | Follow the store's navigation menu (HOME, FEATURED DEALS, SSD, ...) and crawl every linked subpage, not just the landing page. |
maxDepth | integer | optional | How many navigation-link hops to follow from the landing page when crawlSubpages is enabled (1 = landing page's direct subpages only). |
maxPages | integer | optional | Hard cap on the total number of store pages (landing + subpages) fetched per store. |
maxProducts | integer | optional | Hard cap on the number of distinct product (ASIN) records emitted per store. |
includeAssets | boolean | optional | Also emit module/creative-asset records (images, video, CTA text, shoppable-image hotspots) found on each store page, not just product records. |
proxyConfiguration | object | optional | Apify proxy. AUTO (datacenter) is used by default with homepage-priming; the actor escalates to RESIDENTIAL automatically only if it keeps getting blocked. |
Download the published input schema
View complete JSON
{
"description": "Crawl an Amazon Brand Store (/stores/{Brand}/page/{ID}) - navigation, creative modules, and every validated product link on the page(s). Provide storeUrls directly, or productUrls/asins to auto-resolve the brand's store link from the product page.",
"properties": {
"asins": {
"default": [],
"description": "Product ASINs on amazon.com. Same resolution behavior as productUrls.",
"editor": "stringList",
"prefill": [],
"title": "ASINs (resolve brand store, amazon.com)",
"type": "array"
},
"crawlSubpages": {
"default": true,
"description": "Follow the store's navigation menu (HOME, FEATURED DEALS, SSD, ...) and crawl every linked subpage, not just the landing page.",
"prefill": false,
"title": "Crawl subpages",
"type": "boolean"
},
"includeAssets": {
"default": true,
"description": "Also emit module/creative-asset records (images, video, CTA text, shoppable-image hotspots) found on each store page, not just product records.",
"prefill": true,
"title": "Include creative assets",
"type": "boolean"
},
"maxDepth": {
"default": 1,
"description": "How many navigation-link hops to follow from the landing page when crawlSubpages is enabled (1 = landing page's direct subpages only).",
"maximum": 5,
"minimum": 1,
"prefill": 1,
"title": "Max navigation depth",
"type": "integer"
},
"maxPages": {
"default": 10,
"description": "Hard cap on the total number of store pages (landing + subpages) fetched per store.",
"maximum": 50,
"minimum": 1,
"prefill": 3,
"title": "Max store pages to fetch",
"type": "integer"
},
"maxProducts": {
"default": 200,
"description": "Hard cap on the number of distinct product (ASIN) records emitted per store.",
"maximum": 2000,
"minimum": 1,
"prefill": 30,
"title": "Max products per store",
"type": "integer"
},
"productUrls": {
"default": [],
"description": "Amazon product (/dp/{ASIN}) URLs. The actor visits each product page, finds its \"Visit the {Brand} Store\" link, and crawls that store instead.",
"editor": "stringList",
"prefill": [],
"title": "Product URLs (resolve brand store)",
"type": "array"
},
"proxyConfiguration": {
"default": {
"useApifyProxy": true
},
"description": "Apify proxy. AUTO (datacenter) is used by default with homepage-priming; the actor escalates to RESIDENTIAL automatically only if it keeps getting blocked.",
"editor": "proxy",
"prefill": {
"useApifyProxy": true
},
"title": "Proxy configuration",
"type": "object"
},
"storeUrls": {
"default": [
"https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633"
],
"description": "Amazon Brand Store URLs, e.g. `https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633`. At least one of storeUrls / productUrls / asins is required.",
"editor": "stringList",
"prefill": [
"https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633"
],
"title": "Brand Store URLs",
"type": "array"
}
},
"required": [
"storeUrls"
],
"schemaVersion": 1,
"title": "Amazon Brand Store Scraper Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
storeRecords | string | optional | Dataset containing all scraped Brand Store pages, modules/assets, and product records. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "Amazon Brand Store pages, creative modules, and products, with brand identity, subpage navigation, and product links.",
"properties": {
"storeRecords": {
"description": "Dataset containing all scraped Brand Store pages, modules/assets, and product records.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Store pages, assets & products",
"type": "string"
}
},
"title": "Amazon Brand Store Page & Merchandising Crawler Output"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"views": {
"overview": {
"display": {
"component": "table",
"properties": {}
},
"title": "Store pages & products",
"transformation": {
"fields": [
"recordType",
"brand",
"pageName",
"asin",
"title",
"url",
"storeUrl"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Amazon Brand Store Page & Merchandising Crawler
Brands design their Amazon Store page like a mini storefront — navigation tabs, banner creative, and a curated product mix. This actor crawls that storefront, walking the navigation menu into subpages, and returns the page structure, the creative modules, and every product it links to.
What this actor does
- Crawls a Brand Store's landing page and, optionally, the subpages reachable through its own navigation menu.
- Resolves a brand's Store URL automatically when you only have a product page URL or ASIN instead.
- Finds every real product link on each crawled page, with price, rating, and badges included only when actually shown next to that link.
- Optionally captures the page's creative modules: banner images, video, headings, and call-to-action text.
- Reports a page explicitly as blocked or missing rather than silently returning it as an empty store.
A Brand Store is curated by the brand, not a full product catalog — Amazon doesn't guarantee every item a brand sells appears there. This actor reports every product link it can find on the pages it crawls; for a seller's complete catalog, a seller-shop scraper is the better tool.
Output: store page record (recordType: storePage)
| Field | Description |
|---|---|
storeUrl |
The Brand Store URL this page belongs to |
brand |
Brand name |
storePageId |
Page identifier from the URL |
pageName |
Navigation label for this page, e.g. "HOME", "FEATURED DEALS" |
description |
Page meta description, when present |
logoUrl |
Brand logo image |
navigation |
Subpage links found on this page, each with name, url, storePageId, order |
depth |
How many navigation hops from the landing page this page is |
pagePosition |
Position in the crawl order |
scrapedAt |
When the actor collected the record |
Output: creative asset record (recordType: asset, when includeAssets is on)
| Field | Description |
|---|---|
storeUrl, brand, storeSubPage |
Which store and page the asset appears on |
moduleType |
image or video |
heading, bodyText |
Nearby section heading and caption text, when present |
ctaText |
Call-to-action text, e.g. "Shop now" |
imageUrl, imageAlt |
Image modules |
videoUrl, videoThumbnail, videoTitle |
Video modules |
destinationUrl |
Link target, when the asset itself links to a non-product page |
modulePosition |
Position of this module on the page |
scrapedAt |
When the actor collected the record |
Output: product record (recordType: product)
| Field | Description |
|---|---|
asin |
Amazon product ID |
title |
Product title, when visible next to the link |
url |
Product page URL |
thumbnailImage |
Product thumbnail |
price, listPrice |
Price and list price, each with value, currency, display, only when visible on the page |
stars, reviewsCount |
Rating and review count, only when visible near the link |
badge |
One of BestSeller, AmazonsChoice, OverallPick, LimitedTimeDeal, NewOnAmazon, SmallBusiness, only when shown |
discountPercent |
Percent off, only when a discount badge is shown |
brand |
Brand name |
storeUrl, storeSubPage |
Store and page the product was found on |
modulePosition |
Position of the product tile on the page |
scrapedAt |
When the actor collected the record |
Output: page error record (recordType: storePageError)
Emitted instead of a storePage record when a page couldn't be read. Fields: storeUrl, pageClassification (e.g. NOT_FOUND, CAPTCHA, AUTH_REQUIRED), depth, pagePosition.
Input
| Field | Type | Default | Description |
|---|---|---|---|
storeUrls |
Array of strings | ["https://www.amazon.com/stores/soundcore/page/AD6AD8C0-90C7-4C65-8000-0AC741FA2633"] |
Brand Store URLs to crawl. At least one of storeUrls, productUrls, or asins is required. |
productUrls |
Array of strings | – | Product page URLs; the actor finds that product's "Visit the Store" link and crawls the store instead. |
asins |
Array of strings | – | ASINs on amazon.com with the same auto-resolve behavior as productUrls. |
crawlSubpages |
Boolean | true |
Follow the store's own navigation menu into subpages. |
maxDepth |
Integer | 1 |
How many navigation hops to follow from the landing page (1–5). |
maxPages |
Integer | 10 |
Maximum store pages fetched per store, landing page included (1–50). |
maxProducts |
Integer | 200 |
Maximum distinct product records emitted per store (1–2000). |
includeAssets |
Boolean | true |
Also emit creative/module asset records. |
proxyConfiguration |
Proxy | Apify Proxy | Used for every request; automatically escalates to a different proxy tier if the store keeps blocking requests. |
Example: crawl a Brand Store including its subpages
{
"storeUrls": ["https://www.amazon.com/stores/SanDisk/page/CD971F4B-9F97-4E38-B7D0-4E3E0E0E0E0E"],
"crawlSubpages": true,
"maxDepth": 2,
"maxPages": 15,
"maxProducts": 100
}
Example: landing page only, products only (no creative assets)
{
"storeUrls": ["https://www.amazon.com/stores/soundcore/page/HOME"],
"crawlSubpages": false,
"includeAssets": false
}
Example: resolving a store from a product page
{
"storeUrls": [],
"productUrls": ["https://www.amazon.com/dp/B09X7MPX8L"]
}
Use cases
- Brand monitoring teams track how a competitor merchandises and navigates their Amazon storefront.
- Catalog discovery teams find every product a brand currently features on its Store page.
- Creative audit teams collect a brand's storefront imagery, video, and CTA copy in one pass.
- Merchandising researchers compare navigation structure and featured-product mix across brands.
- Pricing teams snapshot the price and rating shown on each Store product tile.
FAQ
Is this the same as a seller's product catalog? No. A Brand Store is a curated page the brand designs; a seller catalog lists everything that seller has for sale. Use this actor for the storefront experience, and a seller-shop tool for the full catalog.
Why do some products have no price or rating? Brand Store product tiles don't always render price or rating in the page itself — a field is only included when it's actually visible next to the product link, never a guessed value.
What if I only have a product URL, not a store URL?
Pass it via productUrls (or the ASIN via asins); the actor opens that product page, follows its "Visit the Store" link, and crawls that store instead.
Does this need a login or cookies? No. Brand Store pages are public.
Why does the actor sometimes report a storePageError instead of products?
Amazon occasionally serves a block or rate-limit page instead of the real store. Rather than reporting zero products as if the store were simply empty, the actor records explicitly what happened on that page.
Does this capture every product a brand sells? No — see "What this actor does" above; a Brand Store is editorially curated, not a full catalog.
Which Amazon marketplaces are supported? Any Amazon domain — amazon.com, amazon.co.uk, amazon.de, and so on — just pass the full Store URL for that marketplace.
Is this affiliated with Amazon? No. This actor independently reads Amazon's public Brand Store pages and is not affiliated with or endorsed by Amazon.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build SChQTsyTIM2B2MOev. Documentation is regenerated from the default published build; private drafts are not included.