Endpoint Playground

Try the Hotels.com hotel search API

Test Crawlora's Hotels.com hotel search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: POST
API path: /hotels/search
Platform: Hotels.com
Auth: apiKey
Credits: 5 credits/request
Required params: request

Hotels.com hotel search API documentation Hotels.com platform page Crawlora API pricing Try Hotels.com Autocomplete API Try Hotels.com room offers API Try Hotels.com property details API Try Hotels.com property rates API Try Hotels.com property reviews API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/hotels/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -X POST \
  --data "{}"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
request (body)	object	Yes		Search request

Example JSON response

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

POSTapiKey5 credits/requesthotels.searchResponseDocHotels.com

POST /hotels/search

Search Hotels.com hotels

Returns a page of date-bound Hotels.com hotel search results for either a free-text destination or a numeric Hotels.com region_id: normalized 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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Loading body editor…

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responsePOST

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

Endpoint details

Method: POST
Path: /hotels/search
Authentication: apiKey
Credit cost: 5 credits/request
Platform: Hotels.com
Parameters: 2 documented fields

Request parameters

request:bodyx-api-key:header

Response schema fields

codedatadata.check_indata.check_outdata.destinationdata.pagedata.propertiesdata.properties[].amenitiesdata.properties[].badgesdata.properties[].iddata.properties[].locationdata.properties[].name

Sample response summary

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

cURL example

curl "https://api.crawlora.net/api/v1/hotels/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -X POST \
  --data "{}"

View endpoint docs Open platform page Browse all endpoints Pricing Get Hotels.com destination suggestions Get Hotels.com room offers Get Hotels.com property details Get Hotels.com rates for one property Get Hotels.com guest reviews

Endpoint Playground

Try the Hotels.com hotel search API

Endpoint facts

Method: POST
API path: /hotels/search
Platform: Hotels.com
Auth: apiKey
Credits: 5 credits/request
Required params: request

Prefilled cURL

curl "https://api.crawlora.net/api/v1/hotels/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -X POST \
  --data "{}"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
request (body)	object	Yes		Search request

Example JSON response

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

POSTapiKey5 credits/requesthotels.searchResponseDocHotels.com

POST /hotels/search

Search Hotels.com hotels

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Loading body editor…

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responsePOST

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

Endpoint details

Method: POST
Path: /hotels/search
Authentication: apiKey
Credit cost: 5 credits/request
Platform: Hotels.com
Parameters: 2 documented fields

Request parameters

request:bodyx-api-key:header

Response schema fields

codedatadata.check_indata.check_outdata.destinationdata.pagedata.propertiesdata.properties[].amenitiesdata.properties[].badgesdata.properties[].iddata.properties[].locationdata.properties[].name

Sample response summary

{
  "code": 200,
  "data": {
    "check_in": "sample",
    "check_out": "sample",
    "destination": "sample",
    "page": 1,
    "properties": [
      {
        "amenities": [
          "sample"
        ],
        "badges": [
          "sample"
        ],
        "id": "sample-id",
        "location": "sample",
        "name": "sample",
        "nightly_price": "sample",
        "price": "sample",
        "review_count": 1,
        "review_score": 1.23,
        "review_title": "sample",
        "strikeout_price": "sample",
        "thumbnail_url": "https://example.com/resource",
        "url": "https://example.com/resource"
      }
    ],
    "region_id": "sample-id",
    "results_label": "sample"
  },
  "msg": "OK"
}

cURL example

curl "https://api.crawlora.net/api/v1/hotels/search" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -X POST \
  --data "{}"