Shopify Public Catalog Map & Promo Watch

Brands, Shopify agencies, and marketplace teams use this actor to monitor public storefront catalog and promo signals. Provide storefront domains, optional collection handles, and promo keywords. The actor returns source-linked catalog map, promo signal, change, report, and product map rows.

Store Quickstart

Run with dryRun=false for user-supplied public storefronts that can be monitored without login, checkout, or private data.

{
  "storeDomains": ["www.allbirds.com"],
  "promoKeywords": ["sale", "discount", "bundle"],
  "authorizedUseConfirmed": true,
  "generateReport": true,
  "emitUnchanged": false,
  "dryRun": false
}

Input Examples

Public storefront promo watch

{
  "storeDomains": ["www.allbirds.com"],
  "promoKeywords": ["sale", "discount", "limited time"],
  "authorizedUseConfirmed": true,
  "dryRun": false
}

Collection-specific watch

{
  "storeDomains": ["www.allbirds.com"],
  "collectionHandles": ["best-sellers", "new-arrivals"],
  "maxProductsPerStore": 100,
  "authorizedUseConfirmed": true,
  "dryRun": false
}

Product map handoff

{
  "storeDomains": ["www.allbirds.com"],
  "emitProductRows": true,
  "generateReport": true,
  "authorizedUseConfirmed": true,
  "dryRun": false
}

Sample Output

{
  "actorName": "shopify-public-catalog-map-promo-watch-scraper",
  "rowType": "shopify_promo_signal",
  "billingEventName": "shopify-promo-signal-detected",
  "storeDomain": "example.myshopify.com",
  "promoKeywordHits": ["bundle"],
  "sourceUrl": "https://example.myshopify.com/products/sample-bundle"
}

Output Fields

• rowType: shopify_catalog_map_summary, shopify_promo_signal, shopify_catalog_map_change, shopify_product_map_item, or shopify_promo_watch_report.
• storeDomain: storefront domain.
• product: public product metadata from storefront surfaces.
• promoSignals: compare-at price or keyword-derived public promo observations.
• sourceUrl: public storefront URL supporting the row.

Pricing And No-Change Runs

• shopify-catalog-map-generated: $0.080 per storefront catalog map summary.
• shopify-promo-signal-detected: $0.060 per source-linked promo signal.
• shopify-catalog-map-change-detected: $0.050 per catalog map change.
• shopify-product-map-item: $0.004 per optional product map item.
• shopify-promo-watch-report: $5.000 per store-level report.

When emitUnchanged=false, repeated unchanged runs emit zero dataset rows and zero charges after state is saved.

Compliance Guardrails

• Public storefront JSON/pages only.
• No admin API, checkout, cart, customer, order, account, or hidden inventory access.
• Non-dry runs require authorizedUseConfirmed=true; use this only for storefront monitoring you are allowed to perform.
• This is an unofficial tool and is not affiliated with Shopify or any monitored storefront.
• Use only for storefront monitoring that is permitted for your context; the actor does not access private merchant data.
• Public prices are observed display values at retrieval time, not contractual pricing.

Bundle Paths

• Competitive Intel: run a low-cost catalog map first, then generate shopify-promo-watch-report when pricing, promo, or collection evidence matters for a client handoff.
• Pair with SaaS Pricing Changelog Battlecard Watch Scraper for broader competitive monitoring.
• Pair with Ad Transparency Creative Change Watch Scraper for campaign and storefront change context.

See Also

• SaaS Pricing Changelog Battlecard Watch Scraper for SaaS pricing/change battlecards.
• Site QA Indexability AI Crawler Report Scraper for owned-site crawler readiness reports.