Skip to main content
GET
/
data
/
hotels
/
semantic-search
Search hotels by semantic query (Beta)
curl --request GET \
  --url https://api.liteapi.travel/v3.0/data/hotels/semantic-search \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "lp5d8a7",
      "name": "Point Pleasant Inn & Resort",
      "main_photo": "https://example.com/hotel-photo.jpg",
      "address": "123 Main Street",
      "city": "Bristol",
      "country": "US",
      "tags": [
        "boutique hotel",
        "coastal retreat",
        "historic charm",
        "waterfront views",
        "romantic getaway"
      ],
      "score": 0.7,
      "persona": "Discerning Couple",
      "style": "Classic Elegance",
      "location_type": "Waterfront Estate",
      "story": "Historic waterfront inn offering an exclusive and tranquil escape near local cultural attractions."
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
query
string
required

Semantic search query. This can be a natural language description of what you're looking for, e.g. 'romantic getaway in london with italian vibes'

​
limit
integer
default:3

Maximum number of results to return. Default is 3.

Required range: x >= 1
​
min_rating
number<float>
default:0

Minimum hotel rating to filter results. Default is 0 (no minimum rating filter).

Required range: x >= 0

Response

OK

​
data
object[]