Store monitoring

Overview

Tracking a store enables automatic daily (or weekly/biweekly) scans with change detection. Every time a tracked store is rescanned, ShopSniffer diffs the new snapshot against the previous one and records per-item changes in a changelog. Use this for competitive intelligence, price tracking, inventory velocity estimation, or catalog change notifications.

What we detect

• New products — items added since the last scan
• Removed products — items that disappeared from the store
• Price changes — variant price and compare-at price updates
• Title & description updates — content changes to products and pages
• New & removed collections — catalog structure changes
• Inventory movements — sales and restocks per product (when the store exposes inventory)

Changes are logged in a per-store changelog. View the change history on the report page, via the dashboard, or programmatically through the monitoring API.

Setting up monitoring

bash
# Track a shop (requires authentication)
curl -X POST https://shopsniffer.com/api/shops \
  -H "X-API-Key: ss_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain": "allbirds.com"}'

# List your tracked shops
curl https://shopsniffer.com/api/shops \
  -H "X-API-Key: ss_your_key_here"

Configuring scan frequency

Each user picks their own cadence per store via PATCH /api/store-detail/:slug/frequency. Options:

• daily — rescanned every day at 12:00 UTC
• weekly — rescanned every Monday at 12:00 UTC (default)
• biweekly — rescanned every other Monday at 12:00 UTC

The effective scan frequency for a store is the most aggressive across all subscribers. If any user tracks a store daily, it's scanned daily — but only that user (and others who opt into daily) get daily notifications. See monitoring workflows for the full rules.

Accessing monitoring data

The monitoring API exposes everything through /api/store-detail/:slug/* endpoints:

Dashboard access

You can also manage tracked shops, frequency, and view the changelog from the Dashboard — it wraps the same API with a built-in chart for the 365-day change heatmap.

Next steps