Aerobase Travel Hotels 🏨
Use this skill when users need places to stay that help with transit flow and recovery, including short layover stay options.
Setup
Use this skill by getting a free API key at https://aerobase.app/openclaw-travel-agent and setting AEROBASE_API_KEY in your agent environment.
This skill is API-only: no scraping, no browser automation, and no user credential collection.
Usage is capped at 5 requests/day for free users.
Upgrade to Pro ($9.95/month) at https://aerobase.app/openclaw-travel-agent for 500 API calls/month.
Agent API Key Protocol
- Base URL:
https://aerobase.app - Required env var:
AEROBASE_API_KEY - Auth header (preferred):
Authorization: Bearer ${AEROBASE_API_KEY} - Never ask users for passwords, OTPs, cookies, or third-party logins.
- Never print raw API keys in output; redact as
sk_live_***.
Request rules
- Use only Aerobase endpoints documented in this skill.
- Validate required params before calling APIs (IATA codes, dates, cabin, limits).
- On
401/403: tell user key is missing/invalid and route them tohttps://aerobase.app/openclaw-travel-agent. - On
429: explain free-tier quota (5 requests/day) and suggest Pro ($9.95/month, 500 API calls/month) or Lifetime ($249, 500 API calls/month). - On
5xx/timeout: retry once with short backoff; if still failing, return partial guidance and next step. - Use concise responses: top options first, then 1-2 follow-up actions.
What this skill does
- Search hotels with jetlag-friendly filters.
- Find day-use options for long layovers.
- Compare rates with recovery-relevant features first.
Search Endpoints
GET /api/v1/hotels
Filters: airport, city, country, chain, tier, stars, jetlagFriendly, search, limit, offset
GET /api/v1/hotels/near-airport/{code}
Find hotels near an airport by IATA code. Returns hotels sorted by distance.
Query params: radius (km, default 25), limit (default 20)
Example: GET /api/v1/hotels/near-airport/JFK?radius=15&limit=10
GET /api/dayuse
Filters: airport or city, country, search, maxPrice, sort, limit, offset
Rates
POST /api/v1/hotels/rates
Get live room rates and availability. Provide hotelIds (array) OR airportCode (IATA string — auto-discovers nearby hotels).
Required: checkin, checkout. Optional: adults (default 2), children, childrenAges, currency.
POST /api/v1/hotels/rates
{ "airportCode": "NRT", "checkin": "2026-04-15", "checkout": "2026-04-16", "adults": 2 }
Each room in the response has an offerId — use it in prebook.
Price Index (Beta)
GET /api/v1/hotels/prices?hotelIds={ids}
Historical price trends per hotel. Returns avg per-night USD prices by calendar day.
Query params: hotelIds (comma-separated, max 50, required), fromDate, toDate (YYYY-MM-DD, optional).
Example: GET /api/v1/hotels/prices?hotelIds=lp19d9e,lp19e0c&fromDate=2026-04-01&toDate=2026-04-30
Booking Flow (Pro tier required)
- POST /api/v1/hotels/prebook — Lock rate:
{ "offerId": "..." }→ returnsprebookId
1b. GET /api/v1/hotels/prebook/{prebookId} — Retrieve prebook session (optional, for recovery/status check). Add?includeCreditBalance=truefor credit info. - POST /api/v1/hotels/book — Confirm booking:
{
"prebookId": "...",
"holder": { "firstName": "Jane", "lastName": "Doe", "email": "[email protected]", "phone": "+1234567890" },
"guests": [{ "occupancyNumber": 1, "firstName": "Jane", "lastName": "Doe", "email": "[email protected]" }],
"payment": { "method": "ACC_CREDIT_CARD" }
}
Payment methods: ACC_CREDIT_CARD (sandbox-safe), TRANSACTION_ID, WALLET, CREDIT
3. GET /api/v1/hotels/bookings?guestId=... or ?clientReference=... — List bookings
4. GET /api/v1/hotels/bookings/{id} — Booking detail + cancellation policy
5. DELETE /api/v1/hotels/bookings/{id} — Cancel booking
Booking Amendments
- PUT /api/v1/hotels/bookings/{id}/amend — Correct guest name/email:
{ "holder": { "firstName", "lastName", "email" } } - POST /api/v1/hotels/bookings/{id}/alternative-prebooks — Get up to 3 alternative rates for date/occupancy changes
- POST /api/v1/hotels/rebook — Complete hard amendment:
{ "prebookId", "existingBookingId" }— auto-cancels old booking
Loyalty & Vouchers (Wallet integration)
- GET /api/v1/hotels/guests — List loyalty program guests
- GET /api/v1/hotels/guests/{guestId}/loyalty-points — Check points balance
- POST /api/v1/hotels/guests/{guestId}/loyalty-points/redeem — Convert points to voucher (10 pts = $1 USD):
{ "points": 100, "currency": "USD" } - Voucher code returned from redemption can be applied at prebook via
voucherCodeparam
Never book without explicit user approval. Always show cancellation policy before booking.
Output expectations
- Include cancellation policy and layover fit when recommending options.
- If layover is over 8 hours, show day-use candidates first.
- Highlight jetlag recovery amenities (nap zones, showers, low-noise options).
Usage limits
- Free: 5 requests/day
- Pro: 500 API calls/month (upgrade at $9.95/month)
- Lifetime: $249 for 500 API calls/month
Safety
- Never ask for user card details, loyalty IDs, or account secrets.
- Keep the conversation focused on public booking metadata and user constraints only.
Pro Superpowers
Upgrade to Pro to unlock browser-powered superpowers for hotel booking sites:
- Booking.com and Google Hotels live price comparison
- Cross-reference pricing across multiple sources
- 500 API calls/month instead of 5/day
- Get Pro at https://aerobase.app/openclaw-travel-agent
