# Hotel Search, Rates & Reviews — Search

> Hotel Search, Rates & Reviews — Search is a paid API for AI agents from hotels.use.x402atlas.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Search for hotels and vacation rentals by destination, returning live nightly rates, star ratings, guest scores, amenities, photos, and GPS coordinates as JSON.

## Facts

- Endpoint: GET https://hotels.use.x402atlas.com/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hotel-search-rates-reviews-search-ca0c84f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1VuN9l-BPpxoAWsbca2oB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hotel-search-rates-reviews-search-ca0c84f0
```

Example prompt: Can you find me hotels in Barcelona and show me the nightly rates, star ratings, and guest scores for each?

## When to prefer this

Use this endpoint when you need to discover and compare multiple hotels or vacation rentals in a destination with live pricing, ratings, and amenities in a single call. It is the entry point in the hotel search workflow — use the returned property tokens to then fetch detailed profiles, reviews, or photos via the sibling endpoints. Prefer this over generic web search when you need structured, clean JSON hotel data with coordinates and real-time rates.

## Known failure modes

- Empty or vague query returns a sample/example response with a note field indicating real parameters should be provided
- No hotels found for obscure or misspelled destinations
- Truncated results if destination query is too broad
- Rate limit or payment failure returns HTTP 402 or error response
- Upstream data unavailability may result in stale or missing nightly rates

## How this service works

Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.

## Output

Returns a JSON object containing an array of hotel property listings for the destination, each with: hotel name, nightly price, star class, overall guest rating, amenities list, thumbnail photo URL, GPS coordinates (latitude/longitude), property token (for use with sibling detail/review/photo endpoints), and booking links. Also includes a list of hotel brand filters and optionally sponsored ad placements.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "description": "Destination, area or hotel name to search (e.g. \"hotels in Barcelona\", \"Bali resorts\")"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "queried_at",
      "properties"
     ],
     "properties": {
      "ads": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "link": {
          "type": "string"
         },
         "name": {
          "type": "string"
         },
         "price": {
          "type": "string"
         },
         "source": {
          "type": "string"
         },
         "reviews": {
          "type": "integer"
         },
         "amenities": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "thumbnail": {
          "type": "string"
         },
         "hotel_class": {
          "type": "integer"
         },
         "source_icon": {
          "type": "string"
         },
         "details_link": {
          "type": "string",
          "description": "This API's /property URL for the ad's hotel"
         },
         "overall_rating": {
          "type": "number"
         },
         "property_token": {
          "type": "string"
         },
         "extracted_price": {
          "type": "number"
         },
         "gps_coordinates": {
          "type": "object",
          "properties": {
           "latitude": {
            "type": "number"
           },
           "longitude": {
            "type": "number"
           }
          }
         },
         "free_cancellation": {
          "type": "boolean"
         }
        }
       },
       "description": "Sponsored placements shown above the organic results"
      },
      "note": {
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Bali Resorts",
  "properties": [
   {
    "link": "https://www.theanvayabali.com/",
    "name": "The Anvaya Beach Resort Bali",
    "type": "hotel",
    "reviews": 14899,
    "amenities": [
     "Free breakfast",
     "Free Wi-Fi",
     "Free parking",
     "Outdoor pool",
     "Spa"
    ],
    "total_rate": {
     "lowest": "$289",
     "extracted_lowest": 289
    },
    "hotel_class": "5-star hotel",
    "photos_link": "https://hotels.use.x402atlas.com/photos?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
    "details_link": "https://hotels.use.x402atlas.com/property?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
    "reviews_link": "https://hotels.use.x402atlas.com/reviews?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
    "check_in_time": "3:00 PM",
    "check_out_time": "11:00 AM",
    "overall_rating": 4.7,
    "property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
    "rate_per_night": {
     "lowest": "$145",
     "extracted_lowest": 145
    },
    "gps_coordinates": {
     "latitude": -8.7322397,
     "longitude": 115.1659119
    },
    "location_rating": 4.7,
    "extracted_hotel_class": 5
   }
  ],
  "queried_at": "2026-07-25T12:00:00Z",
  "total_results": 15000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hotel-search-rates-reviews-search-ca0c84f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hotels.use.x402atlas.com](https://www.zero.xyz/host/hotels.use.x402atlas.com/llms.txt)