# TripAdvisor Hotels, Restaurants & Cruises Scraper (`jdtpnjtp/tripadvisor`) Actor

Scrape TripAdvisor hotels, restaurants, things to do, vacation rentals AND cruises for any city in one run. 5 verticals, full filters, optional detail enrichment. Pay only per result - no subscription.

- **URL**: https://apify.com/jdtpnjtp/tripadvisor.md
- **Developed by:** [Data Forge](https://apify.com/jdtpnjtp) (community)
- **Categories:** Travel, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 place results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## TripAdvisor Hotels, Restaurants & Cruises Scraper

**Scrape every TripAdvisor vertical for a destination in a single run - hotels, restaurants, things to do, vacation rentals, and the one nobody else covers: cruises.** Type a city, tick what you want, and export clean, structured rows. No login, no subscription, pay only per result.

---

### What this actor does

Give it a destination (`Paris`, a geoId, a slug, or a TripAdvisor URL) and it pulls up to **five place types** in one run:

- 🏨 **Hotels** - name, rating, review count, address, price, photo, accommodation type
- 🍽 **Restaurants** - name, rating, cuisines, price band, address (opening hours, delivery/reservation flags in the `data` payload)
- 🎡 **Things to do (attractions)** - name, rating, category, address, photos
- 🏠 **Vacation rentals** - apartment-style stays surfaced through TripAdvisor's Hotels API
- 🚢 **Cruises** - ship, cruise line, sailing date, departure port, nights, fare, plus full ship detail (capacity, crew, year built, itineraries) on demand - **a vertical no other TripAdvisor scraper on Apify Store covers**

Flip on **Also fetch full detail** and every hotel / restaurant / attraction result is enriched with its full detail page (amenities, hours, room/menu info, longer description, more photos) - and every cruise gets its ship detail (capacity, crew, year built, itineraries).

Already have specific pages? Paste them into **Start URLs** - any hotel, restaurant, attraction, listing, search, or destination URL is auto-detected and parsed directly, alongside (or instead of) a destination search.

### Input

| Field | What it does |
|---|---|
| **Destination** | City / region name, geoId, slug, or TripAdvisor URL. Optional if you use Start URLs. |
| **Start URLs** | Paste specific TripAdvisor URLs to parse directly. |
| **Place types** | Multi-select: hotels, restaurants, things to do, cruises, vacation rentals (default: all). |
| **Max results per type** | Cap per vertical. The actor paginates TripAdvisor (30/page) to reach it. |
| **Also fetch full detail** | Enrich every result with its full detail page - hotels / restaurants / attractions and cruise ships (capacity, crew, itineraries). Extra charge per detail. |
| **Currency** | 12 presets + any 3-letter ISO code. |
| **Hotel filters** | Check-in/out dates, adults, rooms, min rating, star class, style, sort. |
| **Restaurant filters** | Price band, meal type, dietary, cuisines, min rating, sort. |
| **Cruise filters** | Destination + cruise line (adaptive: name / id / URL). |

All friendly-label filters (star class, style, price band, meal type, dietary) map to TripAdvisor's internal tag IDs for you - pick **Luxury** or **5 Star**, no IDs to look up.

### Output

One flat row per result, discriminated by `place_type`, with the full payload under `data`. The dataset ships with **five ready-made table tabs** - **Overview**, **Hotels**, **Restaurants**, **Things to do**, and **Cruises** - so each vertical reads as a clean spreadsheet you can sort, filter and export to CSV/Excel/JSON in one click.

Common columns: `name`, `rating`, `review_count`, `price`, `category`, `address`, `url`, `location_id`, `photo_url` (plus `ship_name`, `cruise_line`, `sailing_date`, `departure_port`, `nights` for cruises). Error rows carry an `error_code` and are free - you only pay for real results.

A run-summary record (`OUTPUT` key) reports per-vertical counts and the estimated cost. Live per-event pricing is shown on this actor's Apify Store page.

### Why this actor

- **5 verticals in one run** - most scrapers do hotels OR restaurants. This does all of them, plus cruises.
- **Cruises** - ships, sailings, lines, fares. Nobody else on Apify Store has it.
- **Every filter, friendly labels** - star class, style, cuisine, price, dietary, meal type, dates. No internal IDs to look up.
- **Search or URLs** - search a whole city, or paste exact pages. Both in one actor.
- **Clean per-vertical tabs** - export-ready tables, not a wall of mixed columns.
- **You only pay for results** - errors and your own misconfigurations are never charged.

### More TripAdvisor tools

Part of the USP Ultimate TripAdvisor suite - pick the actor that fits the job:

- **[TripAdvisor Reviews Scraper](https://apify.com/jdtpnjtp/tripadvisor-reviews-bulk)** - bulk-pull every review from a list of hotels, restaurants or attractions.
- **[TripAdvisor URL Parser](https://apify.com/jdtpnjtp/tripadvisor-url-parser)** - paste any TripAdvisor URLs and get the parsed payload per URL, with optional review fan-out.

Prefer the raw API across all 21 TripAdvisor endpoints (reviews, Q&A, photos, OTA prices, awards, and more) with your own key? See the USP Ultimate TripAdvisor API on RapidAPI.

### Need help? Enterprise plans? Custom scraping?

I personally support every customer - drop a message on any channel.

[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/j4dtpnj2tp)
[![WhatsApp](https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://wa.me/380686031542)
[![Email](https://img.shields.io/badge/Email-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:jdtpnjtp@gmail.com)

# Actor input Schema

## `locationQuery` (type: `string`):

Search an entire destination. Accepts a **city/region name** (`Paris`), a **TripAdvisor geoId** (`187147`), a **slug** (`paris-france`) or a full **TripAdvisor URL** - the actor resolves it automatically. Optional if you provide Start URLs below.
## `startUrls` (type: `array`):

Paste specific TripAdvisor URLs to scrape directly - a hotel / restaurant / attraction page, a listing or search page, or a Tourism destination page. Each URL is auto-detected and parsed into its own row, independent of the place types below. Mix freely with (or use instead of) a Destination.
## `placeTypes` (type: `array`):

Which TripAdvisor verticals to pull for the Destination. Defaults to all five. Each selected type is searched independently up to the result cap below. Ignored for Start URLs.
## `maxResultsPerType` (type: `integer`):

Upper bound on search results pulled for EACH selected place type. 20 = quick sample, 100 = solid dataset. The actor paginates TripAdvisor (30/page) under the hood to reach this number.
## `includeDetails` (type: `boolean`):

When on, every hotel / restaurant / attraction / vacation-rental search result is enriched with a second call that pulls its full detail page (amenities, hours, menu/room info, longer description, more photos). **This roughly doubles the per-result cost** (a `place-detail` event is charged on top of the search-result event). Not applied to cruises. Leave off for a fast, cheap listing-only run.
## `currency` (type: `string`):

Currency for hotel prices. Pick from the list or type any 3-letter ISO 4217 code.
## `hotelCheckIn` (type: `string`):

Optional. When both check-in and check-out are set, hotel results carry real dated nightly prices. Format `YYYY-MM-DD` or relative like `3 days`, `1 week`.
## `hotelCheckOut` (type: `string`):

Optional. Pair with check-in for dated prices. Format `YYYY-MM-DD` or relative like `5 days`.
## `hotelAdults` (type: `integer`):

Guests per room, used for dated pricing.
## `hotelRooms` (type: `integer`):

Number of rooms, used for dated pricing.
## `hotelMinRating` (type: `string`):

Keep only hotels at or above this bubble rating.
## `hotelClasses` (type: `array`):

Hotel star class (the official 1-5 star category). Multi-select.
## `hotelStyles` (type: `array`):

Style / vibe filter. Multi-select.
## `hotelSort` (type: `string`):

Order of hotel search results.
## `restaurantPrice` (type: `array`):

Restaurant price band. Multi-select.
## `restaurantMealTypes` (type: `array`):

When the restaurant serves. Multi-select.
## `restaurantDietary` (type: `array`):

Dietary restrictions catered for. Multi-select.
## `restaurantCuisines` (type: `array`):

Filter restaurants by cuisine. Multi-select - pick by name, no IDs to look up. Leave empty for all cuisines.
## `restaurantRatingMin` (type: `string`):

Keep only restaurants at or above this bubble rating.
## `restaurantSort` (type: `string`):

Order of restaurant search results.
## `cruiseDestination` (type: `string`):

Cruise region - e.g. Caribbean, Mediterranean, Alaska, Bahamas. Type a name or paste a TripAdvisor cruise destination URL. At least one of cruise destination or cruise line is required when 'Cruises' is selected.
## `cruiseLine` (type: `string`):

Cruise line - e.g. Royal Caribbean, MSC, Carnival, Norwegian, Disney. Type a name or paste a TripAdvisor cruise line URL.
## `stopOnError` (type: `boolean`):

If on, the run aborts as soon as one place type fails (e.g. UPSTREAM_BLOCKED). If off (default), the failing vertical is logged with a diagnostic row and the run continues with the others.

## Actor input object example

```json
{
  "locationQuery": "Paris",
  "startUrls": [
    "https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-New_York_City_New_York.html"
  ],
  "placeTypes": [
    "hotels",
    "restaurants",
    "things_to_do"
  ],
  "maxResultsPerType": 20,
  "includeDetails": false,
  "currency": "USD",
  "hotelAdults": 2,
  "hotelRooms": 1,
  "hotelMinRating": "",
  "hotelClasses": [],
  "hotelStyles": [],
  "hotelSort": "BEST_VALUE",
  "restaurantPrice": [],
  "restaurantMealTypes": [],
  "restaurantDietary": [],
  "restaurantCuisines": [],
  "restaurantRatingMin": "",
  "restaurantSort": "FEATURED",
  "cruiseDestination": "",
  "cruiseLine": "",
  "stopOnError": false
}
````

# Actor output Schema

## `dataset` (type: `string`):

The default dataset. Each row carries one hotel / restaurant / attraction / vacation-rental / cruise result, discriminated by place\_type, with common fields flattened to top-level columns and the full payload under `data`. Use the Overview / Hotels / Restaurants / Things to do / Cruises tabs to view per-vertical tables.

## `summary` (type: `string`):

A single JSON object written to the default key-value store under the OUTPUT key. Contains per-vertical result/detail counts, total results, errors, estimated\_cost\_usd, limit\_reached, and actor\_version.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locationQuery": "Paris",
    "startUrls": [
        "https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-New_York_City_New_York.html"
    ],
    "placeTypes": [
        "hotels",
        "restaurants",
        "things_to_do"
    ],
    "maxResultsPerType": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("jdtpnjtp/tripadvisor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locationQuery": "Paris",
    "startUrls": ["https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-New_York_City_New_York.html"],
    "placeTypes": [
        "hotels",
        "restaurants",
        "things_to_do",
    ],
    "maxResultsPerType": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("jdtpnjtp/tripadvisor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locationQuery": "Paris",
  "startUrls": [
    "https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-New_York_City_New_York.html"
  ],
  "placeTypes": [
    "hotels",
    "restaurants",
    "things_to_do"
  ],
  "maxResultsPerType": 20
}' |
apify call jdtpnjtp/tripadvisor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jdtpnjtp/tripadvisor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TripAdvisor Hotels, Restaurants & Cruises Scraper",
        "description": "Scrape TripAdvisor hotels, restaurants, things to do, vacation rentals AND cruises for any city in one run. 5 verticals, full filters, optional detail enrichment. Pay only per result - no subscription.",
        "version": "1.0",
        "x-build-id": "IJ6TxFmbS5OhsWGua"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jdtpnjtp~tripadvisor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jdtpnjtp-tripadvisor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/jdtpnjtp~tripadvisor/runs": {
            "post": {
                "operationId": "runs-sync-jdtpnjtp-tripadvisor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/jdtpnjtp~tripadvisor/run-sync": {
            "post": {
                "operationId": "run-sync-jdtpnjtp-tripadvisor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "locationQuery": {
                        "title": "Destination (search a whole city)",
                        "type": "string",
                        "description": "Search an entire destination. Accepts a **city/region name** (`Paris`), a **TripAdvisor geoId** (`187147`), a **slug** (`paris-france`) or a full **TripAdvisor URL** - the actor resolves it automatically. Optional if you provide Start URLs below."
                    },
                    "startUrls": {
                        "title": "Start URLs (parse specific TripAdvisor pages)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Paste specific TripAdvisor URLs to scrape directly - a hotel / restaurant / attraction page, a listing or search page, or a Tourism destination page. Each URL is auto-detected and parsed into its own row, independent of the place types below. Mix freely with (or use instead of) a Destination.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "placeTypes": {
                        "title": "Place types to scrape (Destination search)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Which TripAdvisor verticals to pull for the Destination. Defaults to all five. Each selected type is searched independently up to the result cap below. Ignored for Start URLs.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "hotels",
                                "restaurants",
                                "things_to_do",
                                "cruises",
                                "vacation_rentals"
                            ],
                            "enumTitles": [
                                "🏨 Hotels",
                                "🍽 Restaurants",
                                "🎡 Things to do (attractions)",
                                "🚢 Cruises",
                                "🏠 Vacation rentals (apartments / B&Bs)"
                            ]
                        },
                        "default": [
                            "hotels",
                            "restaurants",
                            "things_to_do",
                            "cruises",
                            "vacation_rentals"
                        ]
                    },
                    "maxResultsPerType": {
                        "title": "Max results per place type",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Upper bound on search results pulled for EACH selected place type. 20 = quick sample, 100 = solid dataset. The actor paginates TripAdvisor (30/page) under the hood to reach this number.",
                        "default": 50
                    },
                    "includeDetails": {
                        "title": "Also fetch full detail for each result",
                        "type": "boolean",
                        "description": "When on, every hotel / restaurant / attraction / vacation-rental search result is enriched with a second call that pulls its full detail page (amenities, hours, menu/room info, longer description, more photos). **This roughly doubles the per-result cost** (a `place-detail` event is charged on top of the search-result event). Not applied to cruises. Leave off for a fast, cheap listing-only run.",
                        "default": false
                    },
                    "currency": {
                        "title": "Currency",
                        "type": "string",
                        "description": "Currency for hotel prices. Pick from the list or type any 3-letter ISO 4217 code.",
                        "default": "USD"
                    },
                    "hotelCheckIn": {
                        "title": "Check-in date",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
                        "type": "string",
                        "description": "Optional. When both check-in and check-out are set, hotel results carry real dated nightly prices. Format `YYYY-MM-DD` or relative like `3 days`, `1 week`."
                    },
                    "hotelCheckOut": {
                        "title": "Check-out date",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
                        "type": "string",
                        "description": "Optional. Pair with check-in for dated prices. Format `YYYY-MM-DD` or relative like `5 days`."
                    },
                    "hotelAdults": {
                        "title": "Adults",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Guests per room, used for dated pricing.",
                        "default": 2
                    },
                    "hotelRooms": {
                        "title": "Rooms",
                        "minimum": 1,
                        "maximum": 8,
                        "type": "integer",
                        "description": "Number of rooms, used for dated pricing.",
                        "default": 1
                    },
                    "hotelMinRating": {
                        "title": "Minimum traveler rating",
                        "enum": [
                            "",
                            "3",
                            "4",
                            "5"
                        ],
                        "type": "string",
                        "description": "Keep only hotels at or above this bubble rating.",
                        "default": ""
                    },
                    "hotelClasses": {
                        "title": "Star class",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Hotel star class (the official 1-5 star category). Multi-select.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "1_star",
                                "2_star",
                                "3_star",
                                "4_star",
                                "5_star"
                            ],
                            "enumTitles": [
                                "★ 1 Star",
                                "★★ 2 Star",
                                "★★★ 3 Star",
                                "★★★★ 4 Star",
                                "★★★★★ 5 Star"
                            ]
                        },
                        "default": []
                    },
                    "hotelStyles": {
                        "title": "Hotel style",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Style / vibe filter. Multi-select.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "budget",
                                "mid_range",
                                "luxury",
                                "family",
                                "business",
                                "romantic",
                                "modern"
                            ],
                            "enumTitles": [
                                "Budget",
                                "Mid-range",
                                "Luxury",
                                "Family-friendly",
                                "Business",
                                "Romantic",
                                "Modern / Design"
                            ]
                        },
                        "default": []
                    },
                    "hotelSort": {
                        "title": "Sort hotels by",
                        "enum": [
                            "BEST_VALUE",
                            "TRAVELER_RANKING",
                            "DISTANCE",
                            "PRICE_LOW_TO_HIGH",
                            "PRICE_HIGH_TO_LOW"
                        ],
                        "type": "string",
                        "description": "Order of hotel search results.",
                        "default": "BEST_VALUE"
                    },
                    "restaurantPrice": {
                        "title": "Price range",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Restaurant price band. Multi-select.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "10953",
                                "10955",
                                "10954"
                            ],
                            "enumTitles": [
                                "$ Cheap eats",
                                "$$ - $$$ Mid-range",
                                "$$$$ Fine dining"
                            ]
                        },
                        "default": []
                    },
                    "restaurantMealTypes": {
                        "title": "Meal type",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "When the restaurant serves. Multi-select.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "10597",
                                "10598",
                                "10599"
                            ],
                            "enumTitles": [
                                "Breakfast",
                                "Lunch",
                                "Dinner"
                            ]
                        },
                        "default": []
                    },
                    "restaurantDietary": {
                        "title": "Dietary options",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Dietary restrictions catered for. Multi-select.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "10665",
                                "10697",
                                "10992"
                            ],
                            "enumTitles": [
                                "Vegetarian friendly",
                                "Vegan options",
                                "Gluten free options"
                            ]
                        },
                        "default": []
                    },
                    "restaurantCuisines": {
                        "title": "Cuisines",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter restaurants by cuisine. Multi-select - pick by name, no IDs to look up. Leave empty for all cuisines.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "5086",
                                "4617",
                                "10654",
                                "10659",
                                "10649",
                                "9908",
                                "5473",
                                "5379",
                                "10346",
                                "10660",
                                "5110",
                                "10655",
                                "10664",
                                "10661",
                                "10675",
                                "10663",
                                "10626",
                                "10687",
                                "10633",
                                "10632",
                                "10639",
                                "10749",
                                "10653",
                                "10643",
                                "10345",
                                "10651",
                                "10668",
                                "10641",
                                "10642",
                                "10640",
                                "10682",
                                "10670",
                                "10683",
                                "10646",
                                "10686",
                                "10679",
                                "10648",
                                "10671",
                                "10669",
                                "10666"
                            ],
                            "enumTitles": [
                                "French",
                                "Italian",
                                "European",
                                "Asian",
                                "Mediterranean",
                                "American",
                                "Japanese",
                                "Chinese",
                                "Indian",
                                "Thai",
                                "Mexican",
                                "Spanish",
                                "Greek",
                                "Korean",
                                "Vietnamese",
                                "Turkish",
                                "Lebanese",
                                "Middle Eastern",
                                "Moroccan",
                                "African",
                                "Latin",
                                "South American",
                                "Sushi",
                                "Seafood",
                                "Steakhouse",
                                "Barbecue",
                                "Grill",
                                "Pizza",
                                "Cafe",
                                "Bar",
                                "Wine Bar",
                                "Pub",
                                "Gastropub",
                                "Fast Food",
                                "Street Food",
                                "Healthy",
                                "International",
                                "Fusion",
                                "Contemporary",
                                "Deli"
                            ]
                        },
                        "default": []
                    },
                    "restaurantRatingMin": {
                        "title": "Minimum traveler rating",
                        "enum": [
                            "",
                            "3",
                            "4",
                            "5"
                        ],
                        "type": "string",
                        "description": "Keep only restaurants at or above this bubble rating.",
                        "default": ""
                    },
                    "restaurantSort": {
                        "title": "Sort restaurants by",
                        "enum": [
                            "FEATURED",
                            "POPULARITY",
                            "RELEVANCE",
                            "AVAILABILITY"
                        ],
                        "type": "string",
                        "description": "Order of restaurant search results.",
                        "default": "FEATURED"
                    },
                    "cruiseDestination": {
                        "title": "Cruise destination",
                        "type": "string",
                        "description": "Cruise region - e.g. Caribbean, Mediterranean, Alaska, Bahamas. Type a name or paste a TripAdvisor cruise destination URL. At least one of cruise destination or cruise line is required when 'Cruises' is selected.",
                        "default": ""
                    },
                    "cruiseLine": {
                        "title": "Cruise line",
                        "type": "string",
                        "description": "Cruise line - e.g. Royal Caribbean, MSC, Carnival, Norwegian, Disney. Type a name or paste a TripAdvisor cruise line URL.",
                        "default": ""
                    },
                    "stopOnError": {
                        "title": "Stop the whole run on the first error",
                        "type": "boolean",
                        "description": "If on, the run aborts as soon as one place type fails (e.g. UPSTREAM_BLOCKED). If off (default), the failing vertical is logged with a diagnostic row and the run continues with the others.",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
