---
title: "Search Hotels.com hotels"
method: POST
path: "/hotels/search"
tags: ["Hotels.com"]
---

# Search Hotels.com hotels

`POST /hotels/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/hotels/search`
- Auth: API key in header `x-api-key`

Returns a page of date-bound Hotels.com hotel search results for either a free-text destination or a numeric Hotels.com region_id: property cards with per-night and per-stay prices, review score and count, location, thumbnail, amenities, and promotional badges. Provide exactly one of query or region_id; region_id skips destination typeahead resolution. Prices are the live rates Hotels.com shows for the requested check-in and check-out dates.

## Headers

- `x-api-key` string, required

## Request body

- HotelsSearchOption
  - `adults` integer
  - `check_in` string, required
  - `check_out` string, required
  - `currency` string
  - `locale` string
  - `page` integer
  - `page_size` integer
  - `query` string
  - `region_id` string
  - `rooms` integer

## Response `200`

OK

- HotelsSearchResponseDoc
  - `code` integer
  - `data` HotelsSearchResponse
    - `check_in` string
    - `check_out` string
    - `destination` string
    - `page` integer
    - `properties` HotelsSearchProperty[]
      - `amenities` string[]
      - `badges` string[]
      - `id` string
      - `location` string
      - `name` string
      - `nightly_price` string
      - `price` string
      - `review_count` integer
      - `review_score` number
      - `review_title` string
      - `strikeout_price` string
      - `thumbnail_url` string
      - `url` string
    - `region_id` string
    - `results_label` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)