Dataspryva

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.

FieldTypeRequiredDescription
storeUrlsarrayrequiredAmazon 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.
productUrlsarrayoptionalAmazon product (/dp/{ASIN}) URLs. The actor visits each product page, finds its "Visit the {Brand} Store" link, and crawls that store instead.
asinsarrayoptionalProduct ASINs on amazon.com. Same resolution behavior as productUrls.
Show all input fields
FieldTypeRequiredDescription
storeUrlsarrayrequiredAmazon 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.
productUrlsarrayoptionalAmazon product (/dp/{ASIN}) URLs. The actor visits each product page, finds its "Visit the {Brand} Store" link, and crawls that store instead.
asinsarrayoptionalProduct ASINs on amazon.com. Same resolution behavior as productUrls.
crawlSubpagesbooleanoptionalFollow the store's navigation menu (HOME, FEATURED DEALS, SSD, ...) and crawl every linked subpage, not just the landing page.
maxDepthintegeroptionalHow many navigation-link hops to follow from the landing page when crawlSubpages is enabled (1 = landing page's direct subpages only).
maxPagesintegeroptionalHard cap on the total number of store pages (landing + subpages) fetched per store.
maxProductsintegeroptionalHard cap on the number of distinct product (ASIN) records emitted per store.
includeAssetsbooleanoptionalAlso emit module/creative-asset records (images, video, CTA text, shoppable-image hotspots) found on each store page, not just product records.
proxyConfigurationobjectoptionalApify 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.

FieldTypeRequiredDescription
storeRecordsstringoptionalDataset 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.

Open the step-by-step Python guide →

Source build SChQTsyTIM2B2MOev. Documentation is regenerated from the default published build; private drafts are not included.