Skip to content
onelayer.
All tools

Tool detail

hotels

Searches hotels via Google Hotels (SerpApi) for a query/city and date range, returning properties with prices, ratings, and amenities.

Categories: Travel booking

Use when

  • search hotels in a city for specific check-in/check-out dates
  • compare hotel prices and ratings for a trip
  • filter hotel search results by star class or price range

Not for

  • not flight or full-itinerary booking — hotel search results only

Inputs

GET query params: q, checkInDate, checkOutDate (required, YYYY-MM-DD); optional adults (default 2), children, currency (default USD), hotelClass, minPrice, maxPrice, sortBy.

Admitted input schema

{
  "type": "object",
  "properties": {
    "adults": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Number of adults",
      "default": "2"
    },
    "checkInDate": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Check-in date (YYYY-MM-DD)",
      "examples": [
        "2026-04-15"
      ]
    },
    "checkOutDate": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Check-out date (YYYY-MM-DD)",
      "examples": [
        "2026-04-18"
      ]
    },
    "children": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Number of children"
    },
    "currency": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Currency code (e.g. USD, EUR)",
      "default": "USD"
    },
    "hotelClass": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Star rating (2-5)"
    },
    "maxPrice": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum price per night"
    },
    "minPrice": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum price per night"
    },
    "q": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Search query — city name or hotel name",
      "examples": [
        "hotels in Paris"
      ]
    },
    "sortBy": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "3=Lowest price, 8=Highest rating, 13=Most reviewed"
    }
  },
  "required": [
    "q",
    "checkInDate",
    "checkOutDate"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://x402engine.app/api/travel/hotels

Payment

Protocol
x402
Listed price
0.02 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://x402engine.app/api/travel/hotels
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z