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: INLINECODE1
• Required env var: INLINECODE2
• Auth header (preferred): INLINECODE3
• 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 to https://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, INLINECODE21

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: INLINECODE24

GET /api/dayuse
Filters: airport or city, country, search, maxPrice, sort, limit, INLINECODE32

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.

CODEBLOCK0

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: INLINECODE45

Booking Flow (Pro tier required)

1. 1. POST /api/v1/hotels/prebook — Lock rate: { "offerId": "..." } → returns INLINECODE47

1. 2. POST /api/v1/hotels/book — Confirm booking:

{
  "prebookId": "...",
  "holder": { "firstName": "Jane", "lastName": "Doe", "email": "jane@example.com", "phone": "+1234567890" },
  "guests": [{ "occupancyNumber": 1, "firstName": "Jane", "lastName": "Doe", "email": "jane@example.com" }],
  "payment": { "method": "ACC_CREDIT_CARD" }
}

1. 3. GET /api/v1/hotels/bookings?guestId=... or ?clientReference=... — List bookings
2. GET /api/v1/hotels/bookings/{id} — Booking detail + cancellation policy
3. DELETE /api/v1/hotels/bookings/{id} — Cancel booking

Booking Amendments

• - PUT /api/v1/hotels/bookings/{id}/amend — Correct guest name/email: INLINECODE54
• 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): INLINECODE56
• Voucher code returned from redemption can be applied at prebook via voucherCode param

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