Api Endpoint

Hotel Search, Rates & Reviews

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

Open interactive test console

Offering

Provider
hotels.use.x402atlas.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Location And Travel
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://hotels.use.x402atlas.com/search
MIME type
application/json
First seen
2026-10-16T01:50:06.715Z
Last seen
Tags
hotels, hotel-search, travel, lodging, accommodation, hotel-prices, hotel-reviews, vacation-rentals, booking, Rates

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.05 USDC
Atomic price: 50000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3
0.05 USDC
Atomic price: 50000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4
0.05 USDC
Atomic price: 50000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "50000",
    "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "50000",
    "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "50000",
    "payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
  }
]

Observed health

Status
Healthy
Latest latency
13 ms
Average latency
287 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "method": {
      "enum": [
        "GET"
      ],
      "type": "string"
    },
    "queryParams": {
      "properties": {
        "query": {
          "description": "Destination, area or hotel name to search (e.g. \"hotels in Barcelona\", \"Bali resorts\")",
          "maxLength": 200,
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "query": {
              "description": "Destination, area or hotel name to search (e.g. \"hotels in Barcelona\", \"Bali resorts\")",
              "maxLength": 200,
              "type": "string"
            }
          },
          "required": [
            "query"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "ads": {
              "description": "Sponsored placements shown above the organic results",
              "items": {
                "properties": {
                  "amenities": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "details_link": {
                    "description": "This API's /property URL for the ad's hotel",
                    "type": "string"
                  },
                  "extracted_price": {
                    "type": "number"
                  },
                  "free_cancellation": {
                    "type": "boolean"
                  },
                  "gps_coordinates": {
                    "properties": {
                      "latitude": {
                        "type": "number"
                      },
                      "longitude": {
                        "type": "number"
                      }
                    },
                    "type": "object"
                  },
                  "hotel_class": {
                    "type": "integer"
                  },
                  "link": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "overall_rating": {
                    "type": "number"
                  },
                  "price": {
                    "type": "string"
                  },
                  "property_token": {
                    "type": "string"
                  },
                  "reviews": {
                    "type": "integer"
                  },
                  "source": {
                    "type": "string"
                  },
                  "source_icon": {
                    "type": "string"
                  },
                  "thumbnail": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "brands": {
              "description": "Hotel brands usable as the brands filter",
              "items": {
                "properties": {
                  "children": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "check_in_date": {
              "description": "Stay window actually priced",
              "format": "date",
              "type": "string"
            },
            "check_out_date": {
              "format": "date",
              "type": "string"
            },
            "next_page_token": {
              "description": "Pass back as next_page_token for the next page",
              "type": "string"
            },
            "note": {
              "description": "Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made.",
              "type": "string"
            },
            "properties": {
              "items": {
                "properties": {
                  "amenities": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "check_in_time": {
                    "type": "string"
                  },
                  "check_out_time": {
                    "type": "string"
                  },
                  "deal": {
                    "type": "string"
                  },
                  "deal_description": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "details_link": {
                    "description": "This API's /property URL for the hotel",
                    "type": "string"
                  },
                  "eco_certified": {
                    "type": "boolean"
                  },
                  "essential_info": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "excluded_amenities": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "extracted_hotel_class": {
                    "type": "integer"
                  },
                  "gps_coordinates": {
                    "properties": {
                      "latitude": {
                        "type": "number"
                      },
                      "longitude": {
                        "type": "number"
                      }
                    },
                    "type": "object"
                  },
                  "health_and_safety": {
                    "description": "Health & safety practices, grouped",
                    "type": "object"
                  },
                  "hotel_class": {
                    "type": "string"
                  },
                  "images": {
                    "items": {
                      "properties": {
                        "original_image": {
                          "type": "string"
                        },
                        "thumbnail": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "link": {
                    "description": "Booking page for the property",
                    "type": "string"
                  },
                  "location_rating": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  },
                  "nearby_places": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "overall_rating": {
                    "type": "number"
                  },
                  "photos_link": {
                    "description": "This API's /photos URL for the hotel",
                    "type": "string"
                  },
                  "prices": {
                    "description": "Per-source offers for the stay",
                    "items": {
                      "properties": {
                        "benefits": {
                          "type": "string"
                        },
                        "discount_remarks": {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "free_cancellation": {
                          "type": "boolean"
                        },
                        "link": {
                          "description": "Booking page for this offer",
                          "type": "string"
                        },
                        "logo": {
                          "type": "string"
                        },
                        "num_guests": {
                          "type": "integer"
                        },
                        "official": {
                          "description": "True when the source is the property itself",
                          "type": "boolean"
                        },
                        "rate_per_night": {
                          "properties": {
                            "before_taxes_fees": {
                              "type": "string"
                            },
                            "extracted_before_taxes_fees": {
                              "type": "number"
                            },
                            "extracted_lowest": {
                              "type": "number"
                            },
                            "lowest": {
                              "type": "string"
                            }
                          },
                          "type": "object"
                        },
                        "rooms": {
                          "description": "Room types this source offers, with per-room and per-rate pricing",
                          "items": {
                            "properties": {
                              "images": {
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              "link": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "num_guests": {
                                "type": "integer"
                              },
                              "rate_per_night": {
                                "properties": {
                                  "before_taxes_fees": {
                                    "type": "string"
                                  },
                                  "extracted_before_taxes_fees": {
                                    "type": "number"
                                  },
                                  "extracted_lowest": {
                                    "type": "number"
                                  },
                                  "lowest": {
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              },
                              "rates": {
                                "items": {
                                  "properties": {
                                    "breakfast_included": {
                                      "type": "boolean"
                                    },
                                    "free_cancellation": {
                                      "type": "boolean"
                                    },
                                    "inclusions": {
                                      "items": {
                                        "type": "string"
                                      },
                                      "type": "array"
                                    },
                                    "link": {
                                      "type": "string"
                                    },
                                    "num_guests": {
                                      "type": "integer"
                                    },
                                    "rate_per_night": {
                                      "properties": {
                                        "before_taxes_fees": {
                                          "type": "string"
                                        },
                                        "extracted_before_taxes_fees": {
                                          "type": "number"
                                        },
                                        "extracted_lowest": {
                                          "type": "number"
                                        },
                                        "lowest": {
                                          "type": "string"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    "total_rate": {
                                      "properties": {
                                        "before_taxes_fees": {
                                          "type": "string"
                                        },
                                        "extracted_before_taxes_fees": {
                                          "type": "number"
                                        },
                                        "extracted_lowest": {
                                          "type": "number"
                                        },
                                        "lowest": {
                                          "type": "string"
                                        }
                                      },
                                      "type": "object"
                                    }
                                  },
                                  "type": "object"
                                },
                                "type": "array"
                              },
                              "total_rate": {
                                "properties": {
                                  "before_taxes_fees": {
                                    "type": "string"
                                  },
                                  "extracted_before_taxes_fees": {
                                    "type": "number"
                                  },
                                  "extracted_lowest": {
                                    "type": "number"
                                  },
                                  "lowest": {
                                    "type": "string"
                                  }
                                },
                                "type": "object"
                              }
                            },
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "source": {
                          "description": "Booking site offering this rate",
                          "type": "string"
                        },
                        "total_rate": {
                          "properties": {
                            "before_taxes_fees": {
                              "type": "string"
                            },
                            "extracted_before_taxes_fees": {
                              "type": "number"
                            },
                            "extracted_lowest": {
                              "type": "number"
                            },
                            "lowest": {
                              "type": "string"
                            }
                          },
                          "type": "object"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "property_token": {
                    "description": "Pass to /property, /reviews and /photos",
                    "type": "string"
                  },
                  "rate_per_night": {
                    "properties": {
                      "before_taxes_fees": {
                        "type": "string"
                      },
                      "extracted_before_taxes_fees": {
                        "type": "number"
                      },
                      "extracted_lowest": {
                        "type": "number"
                      },
                      "lowest": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "ratings": {
                    "items": {
                      "properties": {
                        "count": {
                          "type": "integer"
                        },
                        "stars": {
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "reviews": {
                    "type": "integer"
                  },
                  "reviews_breakdown": {
                    "description": "Themed sentiment breakdown; each entry links back to its filtered reviews",
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "reviews_link": {
                    "description": "This API's /reviews URL for the hotel",
                    "type": "string"
                  },
                  "total_rate": {
                    "properties": {
                      "before_taxes_fees": {
                        "type": "string"
                      },
                      "extracted_before_taxes_fees": {
                        "type": "number"
                      },
                      "extracted_lowest": {
                        "type": "number"
                      },
                      "lowest": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "type": {
                    "description": "hotel or vacation rental",
                    "type": "string"
                  }
                },
                "required": [
                  "name"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "queried_at": {
              "description": "Time the search ran (UTC)",
              "format": "date-time",
              "type": "string"
            },
            "query": {
              "description": "Echoed destination query",
              "type": "string"
            },
            "total_results": {
              "description": "Total properties matching the query upstream",
              "type": "integer"
            }
          },
          "required": [
            "query",
            "queried_at",
            "properties"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}