Add a watched route
add_watchMonitor a flight or train route by adding it to a watchlist; get an immediate fare check with resolved provider codes and continue receiving hourly updates on new offers.
Instructions
Add a route to monitor. originQuery/destinationQuery go through the same resolution as resolve_location for every requested provider, immediately, and the watch stores each provider’s resolved codes — you get that resolution back in the response so you can sanity-check it before relying on the watch. An immediate first check runs right away (you do not have to wait for the hourly cycle to get initial results) and its offers are returned too.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Free-text label to help you recognize this watch later | |
| dateTo | Yes | YYYY-MM-DD | |
| currency | No | Preferred currency code for providers that support choosing one (Kupibilet, SpiceJet). Providers ignore this if they don’t support it and return their own default currency instead — always read the currency field on each offer. | |
| dateFrom | Yes | YYYY-MM-DD | |
| maxPrice | No | Ignore offers above this price (in each provider’s own currency) | |
| providers | No | Provider ids to search; defaults to providers that work without a browser session (currently ryanair, kupibilet, spicejet). Pass ["jetstar"] explicitly to try it anyway. | |
| originQuery | Yes | e.g. "Москва" / "Moscow" / "MOW" | |
| destinationQuery | Yes | e.g. "Таиланд" / "Thailand" / "BKK" |