# Hotels — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for hotels across millions of properties, view room availability and pricing, and get detailed information about accommodations at specific destinations. Get location suggestions and discover popular travel spots to help plan your next getaway.

**Category:** Travel | **Website:** [hotels.com/](https://hotels.com/) | **Docs:** [parse.bot/marketplace/c5797080-c045-4b56-9836-584a59101dc1/hotels-com-api](https://parse.bot/marketplace/c5797080-c045-4b56-9836-584a59101dc1/hotels-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete_destination

Suggest destination names as a user types a query string. Returns matching cities, airports, neighborhoods, and points of interest with their region IDs, coordinates, and types. Use the returned region ID as input to search_hotels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for destination lookup (e.g. 'Istanbul', 'New York', 'Paris') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/autocomplete_destination \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_hotel_details

Retrieve full details for a specific hotel property.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | Hotel property ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/get_hotel_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>"}'
```

### get_hotel_rooms

Get available room types and pricing for a specific hotel.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adults |
| `end_date` | string | Yes | Check-out date (YYYY-MM-DD) |
| `property_id` | string | Yes | Hotel property ID |
| `rooms` | integer | No | Number of rooms |
| `start_date` | string | Yes | Check-in date (YYYY-MM-DD) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/get_hotel_rooms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","end_date":"<string>","property_id":"<string>","rooms":"<integer>","start_date":"<string>"}'
```

### get_popular_destinations

Retrieve a curated list of popular travel destinations with their region IDs. These IDs can be used directly with search_hotels without needing to call autocomplete_destination first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/get_popular_destinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_hotels

Search for hotels by destination and check-in/check-out dates. Returns up to 20 hotel listings sorted by recommendation, each with name, location, nightly and total pricing, guest rating, review summary, image URL, and a direct booking URL. The region_id is obtained from autocomplete_destination or get_popular_destinations. Dates must be in the future.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adults per room |
| `end_date` | string | Yes | Check-out date in ISO format YYYY-MM-DD |
| `query` | string | Yes | Destination name (e.g. 'Istanbul', 'Paris, France') |
| `region_id` | string | Yes | Region ID from autocomplete_destination or get_popular_destinations (e.g. '2734' for Paris, '1639' for Istanbul) |
| `rooms` | integer | No | Number of rooms |
| `start_date` | string | Yes | Check-in date in ISO format YYYY-MM-DD |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotels-com-api-c5797080/search_hotels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","end_date":"<string>","query":"<string>","region_id":"<string>","rooms":"<integer>","start_date":"<string>"}'
```