Hotel Search, Rates & Reviews
GET hotels.use.x402atlas.com/search
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.
Resource: hotels.use.x402atlas.com/search
Network: eip155:8453, eip155:137, eip155:42161 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x28410EaC7393dba041cd5a92eEfe7a8E834310bb
Payment methods: — · Last validation: 2026-09-14 16:40:15.368+00
{
"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": {
"type": "string",
"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."
},
"query": {
"type": "string",
"description": "Echoed destination query"
},
"brands": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"children": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"description": "Hotel brands usable as the brands filter"
},
"properties": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"deal": {
"type": "string"
},
"link": {
"type": "string",
"description": "Booking page for the property"
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"description": "hotel or vacation rental"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"thumbnail": {
"type": "string"
},
"original_image": {
"type": "string"
}
}
}
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "string",
"description": "Booking page for this offer"
},
"logo": {
"type": "string"
},
"rooms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "string"
},
"name": {
"type": "string"
},
"rates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "string"
},
"inclusions": {
"type": "array",
"items": {
"type": "string"
}
},
"num_guests": {
"type": "integer"
},
"total_rate": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"rate_per_night": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"free_cancellation": {
"type": "boolean"
},
"breakfast_included": {
"type": "boolean"
}
}
}
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"num_guests": {
"type": "integer"
},
"total_rate": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"rate_per_night": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
}
}
},
"description": "Room types this source offers, with per-room and per-rate pricing"
},
"source": {
"type": "string",
"description": "Booking site offering this rate"
},
"benefits": {
"type": "string"
},
"official": {
"type": "boolean",
"description": "True when the source is the property itself"
},
"num_guests": {
"type": "integer"
},
"total_rate": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"rate_per_night": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"discount_remarks": {
"type": "array",
"items": {
"type": "string"
}
},
"free_cancellation": {
"type": "boolean"
}
}
},
"description": "Per-source offers for the stay"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"stars": {
"type": "integer"
}
}
}
},
"reviews": {
"type": "integer"
},
"amenities": {
"type": "array",
"items": {
"type": "string"
}
},
"total_rate": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"description": {
"type": "string"
},
"hotel_class": {
"type": "string"
},
"photos_link": {
"type": "string",
"description": "This API's /photos URL for the hotel"
},
"details_link": {
"type": "string",
"description": "This API's /property URL for the hotel"
},
"reviews_link": {
"type": "string",
"description": "This API's /reviews URL for the hotel"
},
"check_in_time": {
"type": "string"
},
"eco_certified": {
"type": "boolean"
},
"nearby_places": {
"type": "array",
"items": {
"type": "object"
}
},
"check_out_time": {
"type": "string"
},
"essential_info": {
"type": "array",
"items": {
"type": "string"
}
},
"overall_rating": {
"type": "number"
},
"property_token": {
"type": "string",
"description": "Pass to /property, /reviews and /photos"
},
"rate_per_night": {
"type": "object",
"properties": {
"lowest": {
"type": "string"
},
"extracted_lowest": {
"type": "number"
},
"before_taxes_fees": {
"type": "string"
},
"extracted_before_taxes_fees": {
"type": "number"
}
}
},
"gps_coordinates": {
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
}
},
"location_rating": {
"type": "number"
},
"deal_description": {
"type": "string"
},
"health_and_safety": {
"type": "object",
"description": "Health & safety practices, grouped"
},
"reviews_breakdown": {
"type": "array",
"items": {
"type": "object"
},
"description": "Themed sentiment breakdown; each entry links back to its filtered reviews"
},
"excluded_amenities": {
"type": "array",
"items": {
"type": "string"
}
},
"extracted_hotel_class": {
"type": "integer"
}
}
}
},
"queried_at": {
"type": "string",
"format": "date-time",
"description": "Time the search ran (UTC)"
},
"check_in_date": {
"type": "string",
"format": "date",
"description": "Stay window actually priced"
},
"total_results": {
"type": "integer",
"description": "Total properties matching the query upstream"
},
"check_out_date": {
"type": "string",
"format": "date"
},
"next_page_token": {
"type": "string",
"description": "Pass back as next_page_token for the next page"
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"tier": "standard",
"version": "2",
"merchant": "x402Atlas"
},
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"amount": "50000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "50000"
},
{
"raw": {
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"tier": "standard",
"version": "2",
"merchant": "x402Atlas"
},
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"amount": "50000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"scheme": "exact",
"network": "eip155:137",
"amountAtomic": "50000"
},
{
"raw": {
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"tier": "standard",
"version": "2",
"merchant": "x402Atlas"
},
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"amount": "50000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
"scheme": "exact",
"network": "eip155:42161",
"amountAtomic": "50000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.