search_stays
Search stays with receipts
Live search of Booking.com, Vrbo and Expedia Group (hotel rooms) for the dates and party, verified against the map. Returns up to three picks (best overall, best value, closest) with receipts and tracked openUrl links. Picks within about a minute and the fine print after that, stopping at two and a half minutes; returns status 'running' with a searchId if it is not done within waitSeconds. Three trips on the house per connection, then a key (free account: five a month; Pro: unlimited).
輸入參數petsvibewhere必填adultsbudgetintentwalkTocheckIn必填checkOut必填childrenflexDaysstayType另有 7 個
The card for a search by searchId: finished picks with receipts, or its running status. Free and instant. Use it to finish a search_stays call that returned 'running', or to read a shared stay (https://stayotter.com/stay/s_…). Each pick's stay card page on the site also draws the block (venues by kind, groceries, nearest stop) and lists map facts for walking back at night; the method is at https://stayotter.com/ground. For a group deciding together, https://stayotter.com/vote/<searchId> is a no-account vote page on the picks.
輸入參數searchId必填travellerCountry
city_picks
Today's verified picks for a covered city
Instant and free: the latest finished standard search for one of the covered cities, about six weeks out, refreshed on a rota: whole homes for two adults and five nights in most cities, a six-adult weekend in New Orleans, Miami, Las Vegas, South Lake Tahoe, Sedona; stayType "hotel" gives the hotel-room trip (two adults, three nights) where one exists (Austin, Lisbon, Kyoto, Mexico City, New York, Paris, Barcelona, Montreal, San Diego, Edinburgh, Honolulu, London, Nashville, Scottsdale, New Orleans, Miami, Las Vegas, South Lake Tahoe, Sedona). Covered: Austin, Lisbon, Kyoto, Mexico City, New York, Paris, Barcelona, Montreal, San Diego, Edinburgh, Honolulu, London, Nashville, Scottsdale, New Orleans, Miami, Las Vegas, South Lake Tahoe, Sedona, Holbox, Niagara-on-the-Lake, Bentonville, Knoxville, Asheville, Canmore, Coeur d'Alene, Broken Bow, Lancaster, Ann Arbor, Da Nang, Hoi An. beachWeek gives the Beach Week Board instead: Playa del Carmen, Cancún, Punta Cana, one January week (2 adults, 5 nights from 2027-01-14) searched every Thursday, its picks grouped by area at stayotter.com/board. For other places or specific dates use search_stays.
輸入參數city必填stayTypebeachWeek
get_activities
Things to do
Top-rated things to do on Viator for a search's spot and dates (what the trip is for first, the city's best otherwise), with a second place to look when the row is thin. Pass a searchId from search_stays or city_picks; intent overrides the search's own.
輸入參數intentsearchId必填
set_alert
Start price-drop alerts
Starts the otter's daily re-run of a finished search, emailing the key's account when a verified pick drops 5% or $50 or the cheapest pick disappears. Needs a key (stayotter.com/connect); the first alert is free with an account, more are Pro.
輸入參數searchId必填
check_listing
Check a listing the traveler found
Reads one place the traveler found themselves into the receipts a pick carries: where it is, whether the street is quiet or lively, bars, cafés and restaurants within a ten-minute walk, the distance to a spot they name and, with dates, the lowest total and the lowest they can still cancel, each read now. Takes a Booking.com, Vrbo or Expedia property page, or a hotel's name and city; Airbnb pages cannot be read. Needs a key: one check a day free, Pro up to thirty. 5 to 60 seconds.
輸入參數cityspottext必填adultscheckIncheckOut
watch_booking
Watch a booking until its free-cancellation deadline
For a stay already booked with free cancellation: pass the confirmation email's text. The otter keeps five facts (property, dates, total paid, deadline, where it was booked), discards the rest (no names, confirmation numbers or card details), reads the property's rate every morning and emails the account when a cheaper rate it can still cancel into appears (5% or $50), with reminders 7, 3 and 1 days before the deadline. Hotels booked direct are read across sellers through Google's rate list. A single whole home has one calendar, so once booked its price can't drop for the traveler: the first read finds the nights taken, the otter emails to say so and offers (free) to watch other whole homes nearby for the same dates until the deadline. A watch that closes without a drop ends with one note saying the price held (the reads and the lowest rate seen); a drop alert asks whether the traveler rebooked, and the answers feed the public track record as totals. Needs a key; free and unlimited. The otter never books or cancels.
輸入參數paidUsdconfirmation必填
get_block
The block around a pick
Ground intelligence for one stay from a finished search: every bar and pub, café, restaurant and grocery within a ten-minute walk (counts, with + when the map read was capped in a dense center), the nearest stop and the walk to it, and map facts for walking back at night (bars within five minutes, the main road, the walk from the traveler's spot). Facts only: no crime figures, no safety rating. The same block is drawn as a map on the pick's stayUrl. Free; usually instant, a few seconds the first time a stay is asked about. Method: https://stayotter.com/ground.
輸入參數searchId必填sourceId必填
watch_similar_homes
Watch other whole homes for a booked stay's dates
For a whole home already booked (watch_booking, then the first morning's read found the nights taken by the traveler): watches other verified whole homes nearby for the same dates and party, and emails the account when one comes in at least 5% or $50 under what they paid, until their free-cancellation deadline. A find is always a different home, never the same one cheaper; the traveler books the new one first and cancels theirs second. Starts with one live search now (30 to 90 seconds; not counted as a trip). Needs the key the booking was watched with; free.
輸入參數bookedId必填