# Tripadvisor (Italy) — 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 travel destinations and discover attractions, restaurants, and things to do at any location by accessing TripAdvisor's comprehensive listings. Find detailed information about popular spots and activities to plan your perfect trip.

**Category:** Travel | **Website:** [www.tripadvisor.it/](https://www.tripadvisor.it/) | **Docs:** [parse.bot/marketplace/edc0b1fe-af7b-4306-a6fb-fc380d3343c5/tripadvisor-it-api](https://parse.bot/marketplace/edc0b1fe-af7b-4306-a6fb-fc380d3343c5/tripadvisor-it-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-tripadvisor-it-api-edc0b1fe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### list_listings

List attractions and things to do for a given TripAdvisor location. Without a category filter, returns the location's cover page with attractions from various category shelves (typically 100-200+ items). With a category filter, returns a structured list page with 30 items per page sorted by traveler favorites. Each listing includes title, rating, review count, category, photo URL, and description when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter ID to narrow results. Common IDs: '47' (Sights & Landmarks), '42' (Tours), '49' (Museums), '41' (Classes & Workshops). Full list returned in the categories field of the response. When provided, returns a paginated list page with 30 results. |
| `geo_id` | string | Yes | TripAdvisor numeric location ID (from search_locations results, e.g. '187791' for Rome, '187147' for Paris). |
| `offset` | string | No | Offset for client-side pagination of cover page results (applied after fetching). Not used for list page pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tripadvisor-it-api-edc0b1fe/list_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","geo_id":"<string>","offset":"<string>"}'
```

### search_locations

Search for travel destinations by name. Returns a list of matching locations with their geo_id (TripAdvisor's numeric location identifier), full name, and coordinates. Use the returned geo_id to fetch listings via list_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location search query (city, region, or country name, e.g. 'Rome', 'Paris', 'New York'). |

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