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