> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopsniffer.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Store monitoring

Track Shopify stores for automated change detection — new products, price changes, content updates, and inventory velocity.

## 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](/api/monitoring).

## 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](/monitoring-workflows#effective-frequency) for the full rules.

## Accessing monitoring data

The [monitoring API](/api/monitoring) exposes everything through `/api/store-detail/:slug/*` endpoints:

**[Snapshot timeline](/api/monitoring#get-store-detail-slug-snapshots)**

Paginated history of every scan for a store.
  **[Changes feed](/api/monitoring#get-store-detail-slug-changes)**

Per-item change log across all snapshots.
  **[Compare two snapshots](/api/monitoring#get-store-detail-slug-compare)**

Side-by-side diff of any two jobs.
  **[Analytics](/api/monitoring#get-store-detail-slug-analytics)**

365-day heatmap and snapshot series.
  **[Inventory events](/api/monitoring#get-store-detail-slug-inventory-events)**

Sales and restocks per product.
  **[Webhooks](/webhooks)**

Get notified on every scan completion.

## Dashboard access

You can also manage tracked shops, frequency, and view the changelog from the [Dashboard](https://shopsniffer.com/dashboard) — it wraps the same API with a built-in chart for the 365-day change heatmap.

## Next steps

**[Monitor prices guide](/guides/monitor-prices)**

End-to-end tutorial: track → frequency → webhook → react.
  **[Monitoring workflows](/monitoring-workflows)**

Background cron schedule and retention policies.
  **[Monitoring API](/api/monitoring)**

Full endpoint reference.
  **[Pricing](/pricing)**

Monitoring requires the Pro Monthly plan.