# GetYourGuide Scraper (`tortuga/getyourguide-scraper`) Actor

Scrape tours and activities from GetYourGuide destination, category and search pages: prices, ratings, reviews count, duration, images and more.

- **URL**: https://apify.com/tortuga/getyourguide-scraper.md
- **Developed by:** [Trevor Ortega](https://apify.com/tortuga) (community)
- **Categories:** Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 activity scrapeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## GetYourGuide Scraper

Scrape tours and activities from GetYourGuide destination, category, attraction and search pages: prices, discounts, ratings, review counts, duration, images, badges and, optionally, the full activity details (highlights, inclusions, languages, cancellation policy, meeting point with coordinates, supplier).

Built for reliability: plain HTTP with browser TLS fingerprinting, no headless browser, no login. Each page carries a server-rendered data blob, so the scraper reads structured JSON instead of fragile CSS selectors. You pay only for the activities you get.

### What data does GetYourGuide Scraper extract?

Every listing item (destination, category, POI, country or search page):

| Field | Description |
|---|---|
| `id` | GetYourGuide activity ID (the `t123456` in the URL) |
| `title` | Activity title |
| `url` | Clean activity URL (tracking params removed) |
| `city` | City / place the activity is in ("Paris", "Chessy") |
| `locationLabel` | Raw label from the card, e.g. "In Paris" or "From Paris" (departure point) |
| `destination` | Name of the destination page the item came from |
| `priceFrom` | Lowest price, number (exact value where the page exposes it, otherwise the displayed rounded price) |
| `currency` | ISO currency code of `priceFrom` |
| `originalPrice` | Pre-discount price when the activity is on sale, else `null` |
| `discountPercent` | Discount in percent when on sale |
| `priceNote` | Pricing unit note such as "per group up to 8" |
| `rating` | Average rating 0-5 |
| `reviewCount` | Number of reviews |
| `duration` | Duration text ("2 hours", "1 - 2 hours", "1 day") |
| `tags` | Card attributes: "Skip the line", "Small group", "Private group", "Meal included", "Pickup available", … |
| `badges` | Badge texts: "Top pick", "Top rated", "Likely to sell out", "#1 selling guided tour", "Certified by GetYourGuide", "Booked 60 times yesterday", … |
| `isBestseller`, `isTopRated`, `isTopPick`, `isLikelyToSellOut`, `isCertified`, `isGygOriginal` | Booleans derived from the badges |
| `images` | Image URLs (card image plus gallery images where available) |
| `nextAvailableDate` | Next available date (ISO) where the page exposes it |
| `sourceUrl`, `scrapedAt` | Start URL that produced the item and the run timestamp |

With **Include activity details** on, each item also gets:

| Field | Description |
|---|---|
| `description` | Short description |
| `fullDescription` | Full description text |
| `highlights` | Highlight bullet points |
| `inclusions` / `exclusions` | "Includes" list split into included and not-included items |
| `notSuitableFor`, `notAllowed`, `whatToBring`, `goodToKnow` | Important-information lists |
| `languages` | Live tour guide languages |
| `audioGuideLanguages` | Audio guide languages |
| `cancellationPolicy`, `freeCancellation` | Cancellation text and flag |
| `reserveNowPayLater`, `skipTheLine`, `wheelchairAccessible`, `privateOrSmallGroup` | Key-detail flags |
| `keyDetails` | All key-detail rows as `{key, title, description}` |
| `meetingPoint` | Meeting point description |
| `latitude`, `longitude` | Meeting point coordinates (falls back to the first itinerary stop) |
| `itinerary` | Itinerary stop names in order |
| `itineraryStops` | Stops with coordinates |
| `supplier`, `supplierUrl` | Activity provider and its GetYourGuide page |
| `ratingBreakdown` | Rating per category, e.g. `{"Guide": 4.2, "Value for money": 4.3}` |

### How to use GetYourGuide Scraper

1. Paste one or more GetYourGuide URLs into **Start URLs**: a destination (`https://www.getyourguide.com/rome-l33/`), a category page, an attraction page (`https://www.getyourguide.com/colosseum-l2619/`), a country page, or a search (`https://www.getyourguide.com/s/?q=rome+food+tour`).
2. Set **Max items** to cap the run (and the cost). Pages hold 24 activities each and are followed automatically.
3. Optionally pick a **Currency** (USD, EUR, GBP, …) and switch on **Include activity details**.
4. Click **Start**. Results appear in the **Dataset** tab; export as JSON, CSV or Excel, or read them through the API.

### Input example

```json
{
  "startUrls": [
    { "url": "https://www.getyourguide.com/paris-l16/" },
    { "url": "https://www.getyourguide.com/s/?q=lisbon+sunset+cruise" }
  ],
  "maxItems": 200,
  "currency": "EUR",
  "includeDetails": true
}
```

### Output example

```json
{
  "id": 193940,
  "title": "1-Hour Seine Cruise departing from the Eiffel Tower",
  "url": "https://www.getyourguide.com/paris-l16/paris-1-hour-seine-cruise-departing-from-the-eiffel-tower-t193940/",
  "city": "Paris",
  "destination": "Paris",
  "priceFrom": 20.92,
  "currency": "USD",
  "originalPrice": null,
  "rating": 4.41,
  "reviewCount": 90162,
  "duration": "1 hour",
  "tags": ["Optional audio guide"],
  "badges": ["#1 selling water activity"],
  "isBestseller": true,
  "images": ["https://cdn.getyourguide.com/img/tour/cf879ee295abc8e4.jpeg/132.jpg"],
  "highlights": ["Embark at the foot of the Eiffel Tower for a Seine cruise aboard a modern boat", "…"],
  "inclusions": ["1-hour river cruise departing from the Eiffel Tower", "Commentary and additional content via a smartphone app available in 11 languages"],
  "exclusions": ["Drinks and snacks", "Souvenir photos"],
  "audioGuideLanguages": ["Spanish", "Chinese", "Dutch", "English", "French", "German", "…"],
  "cancellationPolicy": "Cancel up to 24 hours in advance for a full refund",
  "meetingPoint": "Board at Port de la Bourdonnais (at the foot of the Eiffel Tower) at pontoon no. 3.",
  "latitude": 48.860385,
  "longitude": 2.293565,
  "supplier": "BATEAUX PARISIENS - S.E.V.P.T.E",
  "ratingBreakdown": { "Guide": 4.16, "Transportation": 4.48, "Value for money": 4.34 }
}
```

### How much does it cost?

Pay per result: a small price per activity from a listing page, plus a small extra per activity when **Include activity details** is on (one extra page fetch each). No subscription; Apify's free plan is enough to try it. Scraping 1,000 activities with details costs a few dollars.

### How do I scrape all tours in a city?

Use the destination URL (`https://www.getyourguide.com/<city>-l<id>/`) as the start URL and raise **Max items**. The scraper follows the `?p=2, ?p=3, …` pages until the site stops returning activities. Category pages (`…/<city>-l<id>/<category>-tc<id>/`) work the same way and are the best way to get a specific segment such as food tours or day trips.

### Can I get prices in my currency?

Yes. Set **Currency** to any ISO code GetYourGuide supports (USD, EUR, GBP, CHF, AUD, CAD, JPY, …). Every price in the output, including `originalPrice`, is returned in that currency and `currency` tells you which one was applied.

### Does it work without login or a browser?

Yes. All data comes from public pages that GetYourGuide serves to anonymous visitors. No account, cookies or headless browser are needed, which keeps runs fast and cheap.

### Can I scrape GetYourGuide reviews?

Listing items carry the average rating and review count, and detail items add the rating breakdown per category. Individual review texts are not part of this Actor.

### Integrations and API

Use the run in Zapier, Make, n8n, Google Sheets, or call it from Python/Node with the Apify client. See the **API** tab for ready-made snippets. Schedule it to monitor prices or new activities in a destination.

### Is it legal to scrape GetYourGuide?

This Actor collects only publicly available, non-personal data (activity listings, prices, ratings and supplier business names). It does not collect reviewer identities or any personal data. You are responsible for how you use the data and for complying with GetYourGuide's terms and applicable law.

### Support

Found a bug or need a field added? Open an issue in the **Issues** tab; it is usually answered within a day.

# Actor input Schema

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

GetYourGuide pages to scrape: destination pages (https://www.getyourguide.com/paris-l16/), category pages (.../paris-l16/food-and-drink-tc55/), attraction pages (.../eiffel-tower-l2600/), country pages, or search results (https://www.getyourguide.com/s/?q=rome+food+tour). A single activity URL (…-t123456/) is also accepted and returns that one activity with full details. Each listing page is paginated automatically.

## `maxItems` (type: `integer`):

Stop after this many activities in total (across all start URLs). Keeps cost predictable. Listing pages hold 24 activities each.

## `includeDetails` (type: `boolean`):

Also open every activity page to get the full description, highlights, inclusions/exclusions, languages, cancellation policy, meeting point with coordinates, itinerary stops, supplier and rating breakdown. Slower and charged extra per activity (see pricing).

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

3-letter ISO code (USD, EUR, GBP, …) to show prices in. Leave empty for the site default (USD).

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

Apify Proxy is recommended for reliability. Residential proxies are not required; datacenter IPs worked in testing.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.getyourguide.com/paris-l16/"
    }
  ],
  "maxItems": 100,
  "includeDetails": false,
  "currency": "USD",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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.getyourguide.com/paris-l16/"
        }
    ],
    "currency": "USD",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tortuga/getyourguide-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.getyourguide.com/paris-l16/" }],
    "currency": "USD",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tortuga/getyourguide-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.getyourguide.com/paris-l16/"
    }
  ],
  "currency": "USD",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tortuga/getyourguide-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tortuga/getyourguide-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/02EePDmFuqO9BgrfS/builds/Gd17YlE42nD613JKu/openapi.json