Guides
Schedules
"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:
atis a time you already know, like a drop at 10:00:{ "at": "2026-11-07T10:00:00-05:00", "window": "30m", "every": "1m" }nearisrelease_dateoropens_at, taken fromtarget.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
| Value | Stops |
|---|---|
"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.
| Site | every | burst.every |
|---|---|---|
| The floor for every site | 1m | 1m |
| 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 listings | 1m | 1m |
| Statuspage, Instatus, Twitch | 2m | 1m |
| CoinGecko | 2m (1m with a demo key) | 2m (1m) |
| 5m | 2m | |
| Resy, Eventbrite, Luma, Ticketmaster, DICE, Meetup, Tito, Partiful, Greenhouse, Lever, crates.io, Wikipedia, ActiveNet, Amilia, Mindbody, Mariana Tek, eBay, Discogs, Reverb, Etsy | 5m | 1m |
| Jane App, NexHealth | 5m | 2m |
| GitHub commits, repository stats, issues and pull requests | 5m with GITHUB_TOKEN (30m without) | 2m (10m) |
| Socrata, ArcGIS, Polymarket, Companies House | 5m | 5m |
| CourtListener | 5m | 2m |
| Calendly, OpenTable, SeatGeek, start.gg, Steam, foreUP, GolfNow, Chronogolf, Playtomic, CourtReserve, CivicRec, Zen Planner | 10m | 2m |
| Congress.gov, FRED, username and package name lookups | 10m | 5m |
| NOAA space weather (Kp) | 10m | 10m |
| Tock | 10m | 1m |
| Recreation.gov permits | 15m | 2m |
| 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 changes | 15m | 5m |
| GitHub security advisories | 15m with GITHUB_TOKEN (1h without) | 5m (15m) |
| openFDA | 15m with OPENFDA_API_KEY (1h without) | 15m (30m) |
| OSV.dev | 15m | 15m |
| Stack Exchange | 15m (1m with STACKEXCHANGE_KEY) | 15m (1m) |
| Amazon, Vetstoria, Open Library loans | 30m | 10m |
| WooCommerce, Squarespace, BigCommerce, Magento stores | 30m | 10m |
| GitHub releases, Docker Hub, Sessionize | 30m | 5m |
| Nike | 1h | 5m |
| Any online store, Shopify stores, other stores | 1h | 15m |
| NHTSA, CPSC | 1h | 15m |
| 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 inventory | 1h | 15m |
| BLS and BEA release calendars | 1h | 5m |
| schema.org pages, domain registration (RDAP), AirNow | 1h | 30m |
| Semantic Scholar, hospital price files, TLS certificates, Craigslist | 1h | 1h |
| BLS data | 1h with BLS_API_KEY (6h without) | 1h (6h) |
| NVD | 2h | 2h |
| SAM.gov | 3h | 1h |
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:
"clamped": [{ "field": "schedule.every", "asked": "5m", "used": "30m", "site": "amazon.com", "reason": "amazon.com is checked at most every 30m." }]