# Viator Scraper (`aboo.script/viator-scraper`) Actor

\[💰$5 / 1K] Viator scraper that works on DataDome-protected pages. No login, no API key. Get tours and activities by destination, category, attraction, search URL or keyword: every tour option with price and start times, rating, itinerary, inclusions, meeting point and cancellation policy.

- **URL**: https://apify.com/aboo.script/viator-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Viator Scraper

![Viator Scraper](https://i.ibb.co/Nn1fDfvK/viator-banner.png)

**Viator Scraper** extracts tours, activities, and experiences from [Viator](https://www.viator.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Viator destination, category, attraction, search, or tour URL, or type a few keywords, and get the price, every tour option with its own price and start times, rating, reviews breakdown, duration, itinerary, inclusions, meeting point, cancellation policy, and operator for every tour. Works on DataDome-protected pages, no account or login required.

### Introduction

[Viator](https://www.viator.com/) is a Tripadvisor company and one of the largest marketplaces for tours, attractions, day trips, and things to do, with hundreds of thousands of bookable experiences in destinations all over the world. Travel agencies, tour operators, and analysts follow Viator to understand prices, demand, and competition in a destination.

This actor collects the same public information you see on each Viator tour page and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Viator?

- 🏷️ Tour title, product code, destination, breadcrumbs, description, and highlights
- 💲 Price, price before discount, currency, sale flag, and special offer text
- 🎟️ Every tour option with its name, availability, start times, price, and discount for the next available date
- ⭐ Rating, number of reviews, and the count of 1 to 5 star reviews
- ⏱️ Duration as text and in minutes
- ✅ Inclusions, exclusions, and additional information
- ↩️ Free cancellation flag, cancellation policy, and its full rules
- 🗺️ Itinerary stops with duration, admission, and coordinates
- 📍 Meeting points and end points with address, directions, and coordinates, pickup details, and a map link
- 👥 Languages, age bands, maximum group size, next available date, and time zone
- 🏢 Operator name and ID, private tour, likely to sell out, excellence, and new on Viator flags
- 🖼️ Photos, photo count, and video link
- 🔗 Direct URL to each tour

### Use Cases

- 📈 **Market research**: compare tour prices, durations, and ratings across destinations and categories.
- 🕵️ **Competitor monitoring**: follow what other operators sell, their tour options, discounts, and cancellation terms.
- 🤝 **Lead generation**: build a list of tour operators active in a destination.
- 🗂️ **Database building**: create your own catalog of tours with itineraries, meeting points, and photos.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Viator step by step

1. Paste one or more Viator URLs into **Start URLs**, or type keywords into **Search queries**.
2. Set **Maximum number of results** to how many tours you want per URL or per query.
3. Pick the **Currency** you want the prices in.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Viator URLs to scrape. Supported pages: destination pages (`https://www.viator.com/Dubai/d828-ttd`), category pages (`https://www.viator.com/Dubai-tours/Day-Trips/d828-g5`), attraction pages (`https://www.viator.com/Dubai-attractions/Burj-Al-Arab-Jumeirah/d828-a1615`), search result pages (`https://www.viator.com/searchResults/all?text=louvre`), and single tour pages (`https://www.viator.com/tours/...`). A list URL that ends with a page number starts from that page.
- **Search queries**: keywords to search on Viator, such as a city, an attraction, or an activity. Each query is scraped separately.
- **Maximum number of results**: how many tours to collect for each start URL or search query. Set 0 for no limit. A tour URL always returns one tour.
- **Currency**: the currency of every price in the results (29 currencies, US Dollar by default).
- **Proxy configuration**: residential proxies are required, because Viator blocks datacenter and server IPs. The default setting already uses them.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape the tours of a destination:

```json
{
  "startUrls": [{ "url": "https://www.viator.com/Dubai/d828-ttd" }],
  "maxResults": 5,
  "currency": "USD",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

Search by keywords:

```json
{
  "searchQueries": ["Louvre", "Rome food tour"],
  "maxResults": 5,
  "currency": "USD",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

### Output

Each tour is saved as one item in the dataset. Here is an example of a single item (long lists are shortened):

```json
{
  "url": "https://www.viator.com/tours/Dubai/Luxury-Yacht-Shared-Tour/d828-21100P7",
  "productCode": "21100P7",
  "title": "Dubai Marina Luxury Yacht Tour with Optional Breakfast or BBQ",
  "destination": "Dubai, United Arab Emirates",
  "destinationId": "828",
  "breadcrumbs": ["Things to do in United Arab Emirates", "Things to do in Dubai"],
  "description": "Admire widescreen views of Dubai’s skyline from the water without an expensive private yacht charter on this shared cruise from the Dubai Marina. ...",
  "highlights": [
    "A great choice for photographers and first-time Dubai visitors",
    "View Dubai’s stunning skyline from the Persian Gulf"
  ],
  "price": 24.38,
  "priceBeforeDiscount": null,
  "currency": "USD",
  "isOnSale": false,
  "specialOffer": null,
  "tourOptionsDate": "2026-10-19",
  "tourOptions": [
    {
      "code": "TG15",
      "name": "Twilight Tour",
      "available": true,
      "startTimes": ["21:00"],
      "price": 57,
      "priceBeforeDiscount": null,
      "currency": "USD"
    },
    {
      "code": "TG13",
      "name": "2-Hour Moonlight Tour with BBQ",
      "available": false,
      "startTimes": [],
      "price": null,
      "priceBeforeDiscount": null,
      "currency": null
    }
  ],
  "rating": 4.8,
  "reviewCount": 7927,
  "ratingBreakdown": [
    { "stars": 5, "count": 6973 },
    { "stars": 4, "count": 554 }
  ],
  "duration": "1 to 3 hours (approx.)",
  "durationMinutes": 60,
  "freeCancellation": true,
  "cancellationPolicy": "Free cancellation up to 24 hours in advance",
  "cancellationDetails": [
    "For a full refund, you must cancel at least 24 hours before the experience’s start time.",
    "If you cancel less than 24 hours before the experience’s start time, the amount you paid will not be refunded."
  ],
  "inclusions": [
    "Breakfast and Soft Beverages",
    "Life vests are available for those that wish to use them"
  ],
  "exclusions": ["Hotel pickup and drop-off", "Alcoholic beverage"],
  "additionalInfo": [
    "Confirmation will be received at time of booking",
    "Not wheelchair accessible"
  ],
  "itinerary": [
    {
      "name": "Dubai Marina",
      "description": null,
      "durationMinutes": null,
      "admission": "NO_STOP",
      "passByWithoutStopping": true,
      "latitude": 25.080683,
      "longitude": 55.139797
    }
  ],
  "meetingPoints": [
    {
      "type": "START_AND_END",
      "name": "Xclusive Yachts - Yacht Rental Dubai",
      "address": "34FP+WQW - Al Hubob St - Dubai Marina - Dubai - United Arab Emirates",
      "instructions": "By metro: travel to DMCC metro station -Exit 3 ...",
      "latitude": 25.074817499999998,
      "longitude": 55.1368452
    }
  ],
  "endPoints": [
    {
      "type": "START_AND_END",
      "name": "Xclusive Yachts - Yacht Rental Dubai",
      "address": "34FP+WQW - Al Hubob St - Dubai Marina - Dubai - United Arab Emirates",
      "instructions": "By metro: travel to DMCC metro station -Exit 3 ...",
      "latitude": 25.074817499999998,
      "longitude": 55.1368452
    }
  ],
  "pickupOffered": false,
  "pickupDetails": null,
  "endsAtStartPoint": true,
  "languages": ["English"],
  "ageBands": [
    { "ageBand": "ADULT", "name": "Adult", "minAge": 12, "maxAge": 80 },
    { "ageBand": "CHILD", "name": "Child", "minAge": 3, "maxAge": 11 }
  ],
  "maxTravelers": 30,
  "nextAvailableDate": "2026-10-19",
  "timeZone": "Asia/Dubai",
  "supplierName": "XCLUSIVE YACHTS",
  "supplierId": "21100",
  "isPrivateTour": false,
  "isLikelyToSellOut": false,
  "isExcellent": true,
  "isNewOnViator": false,
  "images": [
    "https://media.tacdn.com/media/attractions-splice-spp-674x446/17/06/2b/0b.jpg",
    "https://media.tacdn.com/media/attractions-splice-spp-674x446/17/06/2b/11.jpg"
  ],
  "photoCount": 167,
  "videoUrl": "https://www.youtube.com/watch?v=S6RDZHpDi00",
  "mapUrl": "https://www.google.com/maps/search/?api=1&query=25.264444,55.311667"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Residential proxies are required. Viator blocks datacenter and server IPs, so keep the default proxy setting.
- Tour options show the "from" price and start times for the next date the tour is available (`tourOptionsDate`). Options that are sold out on that date are still listed, with `available: false` and no price.
- The filters in the Viator sidebar (duration, price, rating, time of day, language, sort order) are not applied, because Viator keeps them in your browser and not in the URL. Use category or attraction pages to narrow the results.
- Viator search returns at most 200 tours per keyword, and it matches by meaning, so even unusual keywords return related tours.
- A tour that appears in several start URLs or queries is saved only once.
- Some tours have no description or highlights on Viator, so those fields are `null` or empty.
- Text is returned in English.

### Why use the Viator Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🛡️ **Works on DataDome-protected pages**: get Viator data without being blocked.
- 🎟️ **Every tour option**: each option comes with its own name, price, discount, and start times, not just the lowest price.
- 🧹 **Clean data**: prices and ratings are real numbers, durations are in minutes, and text is free of HTML.
- 💱 **Your currency**: get every price in one of 29 currencies.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of tours. See **Notes** for the limit of Viator search.

#### Do I need a Viator account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and track prices and availability over time.

#### Why are some fields empty?

Some tours simply do not show every piece of information, such as a video, a pickup area, or a description. When a field is not available on Viator, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, and the currency. If you need other filters or inputs, such as travel dates, number of travelers, or reviews, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

### Need to scrape other tours and activities platforms?

- [GetYourGuide Scraper - Activities & Attractions](https://apify.com/aboo.script/getyourguide-scraper): activities, attractions, prices, ratings, and options from GetYourGuide.
- [Tiqets Scraper - Attractions & Tours](https://apify.com/aboo.script/tiqets-scraper): attraction tickets, tours, and prices from Tiqets.
- [Agoda Activities Scraper](https://apify.com/aboo.script/agoda-scraper): tours, attractions, and tickets from Agoda Activities.
- [Fever Scraper - Events & Experiences](https://apify.com/aboo.script/feverup-scraper): events and experiences by city, category, or keyword from Fever.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Viator](https://www.viator.com/)

# Actor input Schema

## `startUrls` (type: `array`):

Viator URLs to scrape: destination pages (https://www.viator.com/Dubai/d828-ttd), category pages (https://www.viator.com/Dubai-tours/Day-Trips/d828-g5), attraction pages, search result pages or single tour pages (https://www.viator.com/tours/...). A list URL ending with a page number starts from that page.

## `searchQueries` (type: `array`):

Keywords to search on Viator, for example a city, attraction or activity (Louvre, Rome food tour). Each query is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of tours to scrape per start URL or search query. Set 0 for no limit. Tour URLs always return one tour.

## `currency` (type: `string`):

Currency of every price in the results.

## `proxyConfiguration` (type: `object`):

Residential proxies are required, Viator blocks datacenter and server IPs.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.viator.com/Dubai/d828-ttd"
    }
  ],
  "maxResults": 5,
  "currency": "USD",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://www.viator.com/Dubai/d828-ttd"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/viator-scraper").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 = {
    "startUrls": [{ "url": "https://www.viator.com/Dubai/d828-ttd" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/viator-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.viator.com/Dubai/d828-ttd"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call aboo.script/viator-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/viator-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VhGYeTeRN9IcRvI2t/builds/aOaXrTy8W5zcid36k/openapi.json