---
title: "Get Hotels.com destination suggestions"
method: GET
path: "/hotels/autocomplete"
tags: ["Hotels.com"]
---

# Get Hotels.com destination suggestions

`GET /hotels/autocomplete`

## Request

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

Returns Hotels.com search-box suggestions for a partial destination or property name in `q` (up to 120 characters). Each suggestion has its type, primary and secondary text, full location name, coordinates, and region or property id. A query with no match returns an empty `suggestions` list.

## Query parameters

- `q` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HotelsAutocompleteResponseDoc
  - `code` integer
  - `data` HotelsAutocompleteResponse
    - `query` string
    - `suggestions` HotelsSuggestion[]
      - `airport_code` string
      - `geo_type` string
      - `latitude` number
      - `location_full_name` string
      - `longitude` number
      - `primary_text` string
      - `property_id` string
      - `region_id` string
      - `secondary_text` string
      - `type` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/0497899e2016?raw)