Skip to content

Watchlists

Track prices across retailers. Get webhooks on change.

Hand us item ids on any live retailer, a cadence and a webhook URL. We fetch them on schedule, diff every tracked field, delist dead items and POST you a signed event for each change — the same event on every platform. Billed as the calls each run makes.

Get 5,000 free credits Read the docs
fastest cadence
5 minfastest cadence
items per watchlist
50,000items per watchlist
signed webhook events
HMACsigned webhook events

In practice

Create one, get events (Walmart)

request
curl -X POST "https://api.scrapelyserp.com/v1/watchlists"   -H "Authorization: Bearer $SCRAPELY_API_KEY"   -H "Content-Type: application/json"   -d '{
    "name": "Kitchen catalogue",
    "platform": "walmart",
    "marketplace": "us",
    "ids": ["5129928603", "5129936522", "5129944441"],
    "every": "15m",
    "webhook_url": "https://hooks.yourapp.com/scrapely"
  }'
webhook you receive
// POST https://hooks.yourapp.com/scrapely
// Scrapely-Signature: t=1760623331,v1=5257a869e7…
{
  "type": "watchlist.product.changed",
  "data": {
    "watchlist_name": "Kitchen catalogue",
    "platform": "walmart", "marketplace": "us", "currency": "USD",
    "changes": [{
      "id": "5129936522",
      "tier": "standard",
      "changes": {
        "price": { "before": 24.99, "after": 21.49 },
        "inStock": { "before": false, "after": true }
      },
      "snapshot": { "price": 21.49, "inStock": true, … }
    }]
  }
}

Capabilities

What you get with Watchlists

How it works

Three steps, no infrastructure

  1. Create it once

    A name, the platform and marketplace, item ids, a cadence from every 5 minutes to every 7 days, and a webhook URL.

  2. 02

    We run it

    Baseline, sweeps, re-fetches on change and delistings, on your schedule, retried when a run fails.

  3. 03

    You handle events

    watchlist.product.changed carries each field before and after; watchlist.run.completed sums up every run.

Use cases

What it is built for

The workloads it is designed around.

  • Repricing

    Know within minutes when a competitor’s price or stock moves on any retailer you sell on.

  • MAP monitoring

    Catch listings that drop below your minimum advertised price, per retailer.

  • Stock alerts

    Get told when an item comes back in stock or sells out.

  • Catalogue hygiene

    Delisted items arrive as events, so dead SKUs leave your catalogue on their own.

FAQ

Watchlists questions

Which retailers can a watchlist follow?

Every live platform with a live marketplace. The platform pages list them; the dashboard only offers what can be watched today.

How is a watchlist billed?

As the calls each run makes, at the platform’s per-item prices. There is no per-watchlist or per-webhook fee, and every run shows the credits it spent.

Can one watchlist mix retailers?

No: one watchlist, one platform and marketplace. Create one per retailer; they share your balance, your webhook secret and the event format.

Retailers on the same credits

Your first 5,000 credits are on us

Create an account, copy your key, fetch your first products from any live retailer. No card, no subscription, no expiry date on what you buy later.

Get 5,000 free creditsTalk to us about volume

POST api.scrapelyserp.com/v1/products { "platform", "marketplace", "ids": […] }