SERVICE / DETAILsearch

Hotel Search, Rates & Reviews

GET hotels.use.x402atlas.com/search

SONAR SCORE0.646
LIVE PRICE0.050000
BAZAAR LIVEcompatible
CDP INDEXEDno
DECISION EVIDENCE

Why an agent can trust this route.

20 observations in the last 24h
HANDSHAKE SUCCESS100.0%402 challenge reachable
PAID DELIVERY0.0%settlement observed
P90 LATENCY2099msrecent response window
PRICE DRIFT0.0%advertised vs observed

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.

SONAR PROBE HISTORY / 30D

Observed outcomes

JSON ↗
LIVE ENDPOINT METADATA

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"
    }
  ]
}
METADATA PROVENANCE

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.