Last-minute hotel deals with a local price-history database no HotelTonight client has — snapshot deals over time, watch a city for drops, and rank by real % off.
HotelTonight's deals are deliberately ephemeral and geo-local: they appear, drop, and vanish, and you only ever see now, here. This CLI syncs the anonymous deal feed into a local SQLite store and snapshots prices over time, so you (or an agent) can watch a city for drops, see a hotel's real price history, and get an objective cheap/typical/expensive verdict — none of which the app supports.
Printed by @tmchow (Trevin Chow).
Authentication
No account or API key. HotelTonight's consumer endpoints are reachable anonymously; the CLI sends the app-identifying headers it needs automatically. Booking still happens in the app — this tool is read-only.
Quick Start
# See HotelTonight's major markets and their ids (1 = San Francisco, 72 = Austin).
hotel-tonight-pp-cli markets list
# Pull tonight's deals near a location ranked by % off; this also records a price snapshot so history and watch have data to work with.
hotel-tonight-pp-cli deals --lat 37.7749 --lng -122.4194 --sort discount
# Flag rooms under $150 or that dropped since the last snapshot.
hotel-tonight-pp-cli watch --lat 37.7749 --lng -122.4194 --when tonight --below 150
Unique Features
These capabilities aren't available in any other tool for this API.
Local price intelligence
-
watch — Snapshot a location's deals now and get told which rooms dropped below your threshold or fell since you last looked.
Reach for this when an agent needs to monitor a city for last-minute hotel price drops over time instead of re-querying blind.
hotel-tonight-pp-cli watch --lat 37.7749 --lng -122.4194 --when tonight --below 150 --agent
-
history — Show the recorded price and % off history for one hotel from the local store.
Use when you need the actual price trajectory of a hotel rather than a single ephemeral quote.
hotel-tonight-pp-cli history "Argonaut Hotel" --days 30 --agent
-
verdict — Classify a hotel's current quoted price against its own observed low/median/high as cheap, typical, or expensive.
Reach for this to answer 'is this actually cheap?' with a grounded baseline instead of a guess.
hotel-tonight-pp-cli verdict "Argonaut Hotel" --agent
Live deal views
-
compare-neighborhoods — Group tonight's deals in a metro by neighborhood and rank the neighborhoods by median price or best % off.
Use when deciding which area of a city has the best last-minute value tonight.
hotel-tonight-pp-cli compare-neighborhoods --metro 1 --when tonight --agent
-
datescan — Compare a location's deals across tonight, tomorrow, and the weekend in one ranked side-by-side view.
Reach for this to find the cheapest night to stay in an area without running the search repeatedly.
hotel-tonight-pp-cli datescan --lat 30.3071 --lng -97.7354 --agent
-
daily-drop — Reveal today's Daily Drop hotel and its real discounted price for a market (the app hides it behind a slide-to-unlock gate), and with --history read the recorded run of past Daily Drops.
Use to see and track HotelTonight's exclusive once-a-day flash deal, which the app hides until you unlock it and erases each day.
hotel-tonight-pp-cli daily-drop --metro 1 --agent
Usage
Run hotel-tonight-pp-cli --help for the full command reference and flag list.
Commands
inventory
Last-minute hotel deal inventory by location
hotel-tonight-pp-cli inventory - Search last-minute hotel deals near a latitude/longitude for a date range
markets
HotelTonight markets (cities where deals are offered)
hotel-tonight-pp-cli markets get - Get a single market by its numeric idhotel-tonight-pp-cli markets list - List HotelTonight's major markets with location, slug, and category priceshotel-tonight-pp-cli markets nearby - List popular/nearby markets for a given market id
Output Formats
# Human-readable table (default in terminal, JSON when piped)
hotel-tonight-pp-cli inventory --latitude example-value --longitude example-value
# JSON for scripting and agents
hotel-tonight-pp-cli inventory --latitude example-value --longitude example-value --json
# Filter to specific fields
hotel-tonight-pp-cli inventory --latitude example-value --longitude example-value --json --select id,name,status
# Dry run — show the request without sending
hotel-tonight-pp-cli inventory --latitude example-value --longitude example-value --dry-run
# Agent mode — JSON + compact + no prompts in one flag
hotel-tonight-pp-cli inventory --latitude example-value --longitude example-value --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.
Health Check
hotel-tonight-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ``
Static request headers can be configured under headers; per-command header overrides take precedence.
Troubleshooting
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
API-specific
- inventory search returns an error about a bad request — Pass both --latitude and --longitude; the deal feed is geo-anchored and needs a coordinate pair.
- history or verdict says no data for a hotel — Run sync for that area first — those commands read the local snapshot store, which starts empty.
- a market id is not in 'markets list' — The list is a curated set of major markets; any numeric id still resolves via 'markets get ', and search works from any lat/lng.
Generated by CLI Printing Press