---
title: "Get Similar Hotels"
method: GET
path: "/hotel-search/hotels/{hotel_id}/similar/"
tags: ["hotel-search"]
---

# Get Similar Hotels

`GET /hotel-search/hotels/{hotel_id}/similar/`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/hotel-search/hotels/{hotel_id}/similar/`
- Auth: HTTP bearer

Return all four similarity groups together from one catalog lookup.

Rates and availability are not checked. Use hotel search/pricing with the
traveler's dates and occupancy before displaying an available offer.

## Path parameters

- `hotel_id` integer, required

## Query parameters

- `radius_km` number
- `limit` integer: Maximum hotels per group

## Response `200`

Successful Response

- SimilarHotelsResponse
  - `hotel_id` string, required
  - `radius_km` number, required
  - `groups` SimilarHotelGroups, required
    - `most_similar` SimilarHotel[], required
      - `hotel` Hotel, required: Hotel property. Sparse initially (just name), enriched via hotel matching.
        - `id` string, nullable
        - `name` string, required
        - `chain` string, nullable
        - `brand` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `address` string, nullable
        - `postal_code` string, nullable
        - `latitude` number, nullable
        - `longitude` number, nullable
        - `star_rating` number, nullable
        - `review_rating` number, nullable
        - `review_rating_source` string, nullable
        - `phone` string, nullable
        - `email` string, nullable
      - `property_type` string, nullable, required
      - `distance_km` number, required
      - `score` number, required: Heuristic rank, not a probability
      - `reasons` HotelSimilarityReason[], required
      - `shared_amenities` string[], required
      - `unconfirmed_amenities` string[], required: Reference amenities not recorded for this alternative; not proof of absence
      - `star_rating_difference` number, nullable, required
      - `guest_rating_difference` number, nullable, required
    - `nearby` SimilarHotel[], required
      - `hotel` Hotel, required: Hotel property. Sparse initially (just name), enriched via hotel matching.
        - `id` string, nullable
        - `name` string, required
        - `chain` string, nullable
        - `brand` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `address` string, nullable
        - `postal_code` string, nullable
        - `latitude` number, nullable
        - `longitude` number, nullable
        - `star_rating` number, nullable
        - `review_rating` number, nullable
        - `review_rating_source` string, nullable
        - `phone` string, nullable
        - `email` string, nullable
      - `property_type` string, nullable, required
      - `distance_km` number, required
      - `score` number, required: Heuristic rank, not a probability
      - `reasons` HotelSimilarityReason[], required
      - `shared_amenities` string[], required
      - `unconfirmed_amenities` string[], required: Reference amenities not recorded for this alternative; not proof of absence
      - `star_rating_difference` number, nullable, required
      - `guest_rating_difference` number, nullable, required
    - `similar_amenities` SimilarHotel[], required
      - `hotel` Hotel, required: Hotel property. Sparse initially (just name), enriched via hotel matching.
        - `id` string, nullable
        - `name` string, required
        - `chain` string, nullable
        - `brand` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `address` string, nullable
        - `postal_code` string, nullable
        - `latitude` number, nullable
        - `longitude` number, nullable
        - `star_rating` number, nullable
        - `review_rating` number, nullable
        - `review_rating_source` string, nullable
        - `phone` string, nullable
        - `email` string, nullable
      - `property_type` string, nullable, required
      - `distance_km` number, required
      - `score` number, required: Heuristic rank, not a probability
      - `reasons` HotelSimilarityReason[], required
      - `shared_amenities` string[], required
      - `unconfirmed_amenities` string[], required: Reference amenities not recorded for this alternative; not proof of absence
      - `star_rating_difference` number, nullable, required
      - `guest_rating_difference` number, nullable, required
    - `similar_quality` SimilarHotel[], required
      - `hotel` Hotel, required: Hotel property. Sparse initially (just name), enriched via hotel matching.
        - `id` string, nullable
        - `name` string, required
        - `chain` string, nullable
        - `brand` string, nullable
        - `city` string, nullable
        - `country` string, nullable
        - `address` string, nullable
        - `postal_code` string, nullable
        - `latitude` number, nullable
        - `longitude` number, nullable
        - `star_rating` number, nullable
        - `review_rating` number, nullable
        - `review_rating_source` string, nullable
        - `phone` string, nullable
        - `email` string, nullable
      - `property_type` string, nullable, required
      - `distance_km` number, required
      - `score` number, required: Heuristic rank, not a probability
      - `reasons` HotelSimilarityReason[], required
      - `shared_amenities` string[], required
      - `unconfirmed_amenities` string[], required: Reference amenities not recorded for this alternative; not proof of absence
      - `star_rating_difference` number, nullable, required
      - `guest_rating_difference` number, nullable, required
  - `candidate_limit_reached` boolean, required
  - `availability` 'not_checked', required

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-03** `d4989591afbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/hotel-search/hotels/:hotel_id/similar/get.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/8824999a7a0a?raw)