Skip to main content
POST
/
v1
/
hotel_search
Search live hotel inventory and rates
curl --request POST \
  --url https://api.example.com/v1/hotel_search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "city_name": "Paris",
  "country_code": "fr",
  "checkin": "2026-09-01T00:00:00.000Z",
  "checkout": "2026-09-04T00:00:00.000Z",
  "adults": 2,
  "currency": "USD"
}
'
{
  "hotels": [
    {
      "hotel_id": "htl_8f21a9c0",
      "name": "Hôtel Le Marais",
      "address": "12 Rue de Rivoli",
      "city": "Paris",
      "country_code": "FR",
      "star_rating": 4,
      "rating": 8.6,
      "review_count": 1243,
      "images": [
        "https://images.gojinko.com/hotels/htl_8f21a9c0/1.jpg"
      ],
      "thumbnail_url": "https://images.gojinko.com/hotels/htl_8f21a9c0/thumb.jpg",
      "rooms": [
        null
      ]
    }
  ],
  "total": 87
}
Search live hotel inventory and nightly rates for a destination and stay window. It handles requests like “three nights in Lisbon next weekend for two adults” or “family room in Rome with one child in August”. Each result includes an htl_* offer token you can hand to the trip tool to start a booking.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
checkin
string
required
Pattern: ^\d{4}-\d{2}-\d{2}$
​
checkout
string
required
Pattern: ^\d{4}-\d{2}-\d{2}$
​
query
string
Example:

"Paris"

​
city_name
string
​
country_code
string
Required string length: 2
​
latitude
number
​
longitude
number
​
radius_km
number
Required range: 0 < x <= 50
​
place_id
string
​
hotel_ids
string[]
​
occupancies
object[]
​
adults
integer
Required range: x >= 1
​
children
integer[]
​
rooms
integer
Required range: x >= 1
​
currency
string
​
guest_nationality
string
Required string length: 2
​
min_rating
number
​
min_star_rating
integer
Required range: 1 <= x <= 5
​
star_rating
integer
Required range: 1 <= x <= 5
​
max_star_rating
integer
Required range: 1 <= x <= 5
​
min_reviews
integer
​
max_results
integer

Page size — max hotels returned (the limit). Default 50.

​
offset
integer

Pagination offset — skip this many hotels at the upstream search. Default 0.

Required range: x >= 0
​
hotel_type_ids
string[]
​
chain_ids
string[]
​
facility_ids
string[]

Response

Matching hotels

​
hotels
object[]
​
total
number
Example:

87