Hotel Search, Rates & Reviews

Method	Path	Description	Cost
GET	/reviews	Hotel reviews — a hotel's guest reviews by property token: rating, date, text, per-aspect subratings, highlights & the owner's reply, with category filter & paging.	$0.02 default	View details
GET	/search	Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.	$0.06 default	View details

GET/reviews

$0.02 default

Description

Hotel reviews — a hotel's guest reviews by property token: rating, date, text, per-aspect subratings, highlights & the owner's reply, with category filter & paging.

Pricing

$0.02 default

Parameters

{
  "properties": {
    "hl": {
      "default": "en",
      "description": "Language code for the reviews",
      "maxLength": 5,
      "type": "string"
    },
    "property_token": {
      "description": "Property token from a /hotels/search result",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "property_token"
  ],
  "type": "object"
}

Example response

{
  "next_page_token": "CjEIARIpCgoAP7_LACda____EhCB3gky7h3XYNgvXm4AAAAAGgn92PoCYUlVH7AYACIA:10",
  "property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
  "queried_at": "2026-07-25T12:00:00Z",
  "reviews": [
    {
      "best_rating": 5,
      "date": "4 months ago",
      "hotel_highlights": [
        "Romantic"
      ],
      "rating": 4,
      "snippet": "What a beautiful place to stay! The location is perfect. The breakfast buffet was amazing — huge and full of variety. The pool area is absolutely beautiful and a perfect spot to unwind.",
      "source": "Google",
      "subratings": {
        "location": 5,
        "rooms": 4,
        "service": 4
      },
      "user": {
        "link": "https://www.google.com/maps/contrib/100815052880274933640?hl=en",
        "name": "Ramandeep kaur"
      }
    }
  ]
}

GET/search

$0.06 default

Description

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

Pricing

$0.06 default

Parameters

{
  "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"
}

Example response

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