Snag Watcher

Guides

Schedules

JSON
"schedule": {
  "every": "1d",
  "start_at": "2026-12-01T09:00",
  "burst": { "near": "release_date", "window": "48h", "every": "1h" },
  "until": "+90d"
}

A duration is a number followed by m, h or d.

every

every is how often the watcher checks. Each check moves up to 10% earlier or later, at most 5 minutes, so watchers made at the same time don't all fetch at once.

start_at

The first check runs at start_at, or right away if you leave it out. A time without an offset is read as UTC.

burst

A burst checks every burst.every instead of every inside a window centered on one moment, like a release or a ticket on-sale. Give the moment one of two ways:

  • at is a time you already know, like a drop at 10:00: { "at": "2026-11-07T10:00:00-05:00", "window": "30m", "every": "1m" }
  • near is release_date or opens_at, taken from target.attributes, or from the page once a check sees it.

A 48h window runs from a day before to a day after. burst.every has to be shorter than every.

until

ValueStops
"2027-01-31"At the end of that day, UTC
"+30d"30 days after start_at, or from now if there's no start_at
"after_first_match"After the first match, with status matched
"never"When you delete it

A date or a + duration can be at most a year from now.

Minimum intervals

Each site has a fastest interval. If you ask for faster, we still create the watcher but use the site's minimum and list the change in clamped. A value in brackets under burst.every goes with the case in brackets under every.

Siteeveryburst.every
The floor for every site1m1m
Cal.com, Hacker News, Bluesky, SEC EDGAR, Trusted Traveler, USGS, National Weather Service alerts, DexScreener, OpenSea, Magic Eden, Etherscan, Kalshi, stock quotes (Finnhub), crypto exchange listings1m1m
Statuspage, Instatus, Twitch2m1m
CoinGecko2m (1m with a demo key)2m (1m)
Reddit5m2m
Resy, Eventbrite, Luma, Ticketmaster, DICE, Meetup, Tito, Partiful, Greenhouse, Lever, crates.io, Wikipedia, ActiveNet, Amilia, Mindbody, Mariana Tek, eBay, Discogs, Reverb, Etsy5m1m
Jane App, NexHealth5m2m
GitHub commits, repository stats, issues and pull requests5m with GITHUB_TOKEN (30m without)2m (10m)
Socrata, ArcGIS, Polymarket, Companies House5m5m
CourtListener5m2m
Calendly, OpenTable, SeatGeek, start.gg, Steam, foreUP, GolfNow, Chronogolf, Playtomic, CourtReserve, CivicRec, Zen Planner10m2m
Congress.gov, FRED, username and package name lookups10m5m
NOAA space weather (Kp)10m10m
Tock10m1m
Recreation.gov permits15m2m
Recreation.gov campsites, Acuity, Square Appointments, SimplePractice, SignUpGenius, Zocdoc, Fresha, Booksy, Vagaro, Boulevard, MyChart, Ashby, Workday, SmartRecruiters, npm, PyPI, feeds, YouTube, Federal Register, Grants.gov, Regulations.gov, USAJOBS, US wildfires, InciWeb, road work (WZDx), HiBid, Bidsquare, Spectrum Wine, learned recipes, page changes15m5m
GitHub security advisories15m with GITHUB_TOKEN (1h without)5m (15m)
openFDA15m with OPENFDA_API_KEY (1h without)15m (30m)
OSV.dev15m15m
Stack Exchange15m (1m with STACKEXCHANGE_KEY)15m (1m)
Amazon, Vetstoria, Open Library loans30m10m
WooCommerce, Squarespace, BigCommerce, Magento stores30m10m
GitHub releases, Docker Hub, Sessionize30m5m
Nike1h5m
Any online store, Shopify stores, other stores1h15m
NHTSA, CPSC1h15m
Open States, USAspending, House trade reports, ClinicalTrials.gov, arXiv, PubMed, Europe PMC, U.S. Treasury Fiscal Data, European Central Bank, Legistar, Open Library, apartment listings (AppFolio, SightMap), Hart Davis Hart, WineBid, Dealer.com inventory1h15m
BLS and BEA release calendars1h5m
schema.org pages, domain registration (RDAP), AirNow1h30m
Semantic Scholar, hospital price files, TLS certificates, Craigslist1h1h
BLS data1h with BLS_API_KEY (6h without)1h (6h)
NVD2h2h
SAM.gov3h1h

A store named by its host is checked at most hourly, since its platform isn't known until the first check. A url match on a product link that shows the platform (/product/<slug> on WooCommerce, /<shop>/p/<slug> on Squarespace, <key>.html on Magento) gets that platform's 30m.

Asking Amazon for every 5 minutes returns:

JSON
"clamped": [{ "field": "schedule.every", "asked": "5m", "used": "30m", "site": "amazon.com", "reason": "amazon.com is checked at most every 30m." }]