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

# Price & Restock Monitoring

> Track price drops and back-in-stock changes instead of page text

Site Spy has a monitoring mode built specifically for shopping pages. Instead of diffing the page text — which fires on every rotating banner and "5 people are viewing this" counter — it extracts the product's **price** and **availability** and alerts on those alone.

Use it for price drops, back-in-stock alerts, and competitor pricing.

## How it finds the price

On each check Site Spy reads the page's structured product data — LD-JSON, microdata, and OpenGraph product properties — to pull out price, currency, and stock status. Most large shops publish this because search engines require it, so it usually works with no configuration.

If a page publishes no structured data, or publishes several conflicting prices for one product, this mode cannot read it. Fall back to ordinary text monitoring with a filter aimed at the price element — see [CSS & XPath Filters](/docs/dashboard/css-xpath-filters).

## Options

| Setting              | What it does                                                                                                                                   |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Restock detection    | `In stock only` alerts on out-of-stock → in-stock transitions; `Any availability change` alerts in both directions; `Off` ignores availability |
| Follow price changes | Whether price movements notify you at all                                                                                                      |
| Price threshold (%)  | Ignore movements smaller than this, so a 1% wobble doesn't wake you                                                                            |
| Below price          | Only notify when the price drops under this number                                                                                             |
| Above price          | Only notify when the price rises over this number                                                                                              |

A typical restock watch is availability-only. A typical price watch sets a below-price target and a threshold to filter out noise.

## Turning it on

Price and restock monitoring is set through the [API](/api-reference/introduction) by creating a watch with `processor: restock_diff`, along with `in_stock_only`, `follow_price_changes`, and `price_change_threshold_percent`. Bulk import accepts the same processor for a whole list of product URLs at once.

The easiest route without touching the API is the [Community](/docs/dashboard/community) directory: clone a published restock watch for a shop you use and the mode and its settings come with it.

<Note>
  There is no dashboard control for this mode yet — the watch settings dialog covers text monitoring only. Existing price and restock watches keep working and show as "Re-stock detection" on share and community pages.
</Note>

## Notifications

Alerts flow through the same channels as any other watch — see [Email](/docs/dashboard/email-notifications), [Telegram](/docs/dashboard/telegram), [push](/docs/dashboard/push-notifications), and [webhooks](/docs/dashboard/webhooks) — and are subject to the same per-watch limit of 4 an hour and 24 a day.
