Skip to content

Watchlists

Scheduled scraping that tells you what changed.

Give us item ids on any live retailer and a schedule. Each run follows the pipeline you build: which scraper reads what, what a change, a match or a failure leads to, and where the results land. Signed webhooks, your own S3-compatible bucket, or both. Billed as the calls each run makes.

Get 5,000 free credits Read the docs
fastest schedule
5 minfastest schedule
items per watchlist
50,000items per watchlist
in your time zone
Cronin your time zone

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. Pick what to watch

    Item ids on any live retailer. Paste them from a spreadsheet, or send them from code.

  2. 02

    Build each run

    Start from a template or chain your own steps and rules, then choose a cadence or a cron schedule.

  3. 03

    Get the results

    Signed webhook events, files in your bucket, and a full run history in the dashboard.

Use cases

What it is built for

The workloads it is designed around.

  • Repricing

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

  • MAP monitoring

    Get a match event the moment a listing drops below your minimum advertised price.

  • Stock alerts

    Get told the moment an item comes back in stock, sells out, or an exact offer stops being buyable.

  • Scheduled exports

    Refresh your whole catalogue every morning and land the results in your bucket for your warehouse to pick up.

FAQ

Watchlists questions

What can a watchlist follow?

Products on every live retailer and marketplace, by item id. The dashboard only offers what can be watched today.

How is a watchlist billed?

As the calls each run makes, at the same prices as calling the API yourself. There is no per-watchlist, scheduling or delivery fee, and every run shows the credits it spent.

Where do results go?

To your webhook endpoints, each with its own signing secret, and to your S3-compatible bucket (AWS S3, Cloudflare R2, Wasabi, MinIO…) if you connect one. You can also pull changes over the API.

Can I schedule with cron?

Yes: a standard five-field cron expression in any IANA time zone, or a simple cadence from every 5 minutes to every 7 days.

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": […] }