# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/trivago/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/trivago/autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/trivago/get-hotel-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/trivago/search-hotels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","arrival":"<string>","currency":"<string>","departure":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.