# Trivago — 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 hotels across Trivago by destination, dates, and guest count. Filter by price range and currency, get autocomplete suggestions for locations, and retrieve detailed hotel information including star ratings, guest reviews, and pricing from multiple booking sites.

**Category:** Travel | **Website:** [trivago.com.br/](https://trivago.com.br/) | **Docs:** [parse.bot/marketplace/8143c033-cb40-44c0-9e8d-1726afb204ca/trivago-com-br-api](https://parse.bot/marketplace/8143c033-cb40-44c0-9e8d-1726afb204ca/trivago-com-br-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-trivago-com-br-api-8143c033/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete

Autocomplete/suggest destinations as the user types a location name. Returns up to 5 suggestions including cities, regions, airports, and landmarks. Each suggestion includes a structured nsid (namespace/id pair) usable with search_hotels internally, a human-readable type, and a location label for disambiguation.

**Estimated cost:** Metered

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

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

### get_hotel_info

Get detailed information about a specific hotel including name, star rating, guest rating, review count, address, coordinates, and photo count. The hotel_id is obtained from search_hotels results in 'ns/id' format.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hotel_id` | string | Yes | Hotel ID in format 'ns/id' (e.g. '100/49218', '100/12268'). The ID can be obtained from search_hotels results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-trivago-com-br-api-8143c033/get_hotel_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"<string>"}'
```

### search_hotels

Search for hotels in a destination with dates, guest info, and price filters. Resolves the location name to an internal ID via autocomplete, then polls Trivago's search backend to collect results with pricing from multiple booking sites. Returns up to 45 hotels per search. Each hotel includes star rating, guest rating, best deal price, booking site, and distance to landmarks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adults (1-6) |
| `arrival` | string | No | Arrival/check-in date in YYYY-MM-DD format. Omitting defaults to 14 days from today. |
| `currency` | string | No | Currency code for prices (e.g. 'USD', 'BRL', 'EUR') |
| `departure` | string | No | Departure/check-out date in YYYY-MM-DD format. Omitting defaults to 18 days from today. |
| `location` | string | Yes | Location name to search (e.g. 'Paris', 'New York', 'London') |
| `max_price` | integer | No | Maximum price per night in selected currency. Omitting returns all price ranges. |
| `min_price` | integer | No | Minimum price per night in selected currency |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-trivago-com-br-api-8143c033/search_hotels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","arrival":"<string>","currency":"<string>","departure":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>"}'
```