# GetYourGuide Tours & Activities Scraper (`parsebird/getyourguide-scraper`) Actor Scrape GetYourGuide tours and activities by query or URL. Extract titles, prices, ratings, reviews, images, highlights, durations, and cancellation policies. Export JSON, CSV, Excel. - **URL**: https://apify.com/parsebird/getyourguide-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** Travel, Real estate, Automation - **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.59 / 1,000 getyourguide activities 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ### GetYourGuide Tours & Activities Scraper GetYourGuide Tours & Activities Scraper extracts structured tour and activity data from [GetYourGuide](https://www.getyourguide.com/) by search query, search URL, city URL, or direct activity URL.
Search destinations or enrich specific GetYourGuide activity pages to collect titles, prices, ratings, reviews, images, highlights, durations, and cancellation policies.

ParseBird GetYourGuide Suite   •  Review, tour, and activity data tools
 GetYourGuide Review Scraper
Product reviews 		 GetYourGuide Tours & Activities Scraper
➤ You are here
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```text Use Apify Actor parsebird/getyourguide-scraper to scrape GetYourGuide tours and activities. Example with ApifyClient: client.actor("parsebird/getyourguide-scraper").call(run_input={"query":"rome","maxItems":5}). Inputs: query string optional default "rome"; startUrls array optional for activity, search, or city URLs and overrides query; maxItems integer 1-500 default 3; proxyConfiguration object optional. Output fields: type, id, url, title, shortDescription, city, country, price, currency, rating, reviewCount, duration, category, language, images, highlights, cancellationPolicy, scrapedAt. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations. ```` ### What is GetYourGuide Tours & Activities Scraper? **GetYourGuide Tours & Activities Scraper** is a GetYourGuide scraper and GetYourGuide API alternative for collecting public tour and activity data at scale. Search a city such as `rome`, pass a GetYourGuide search URL, or enrich specific activity URLs to get structured activity data ready for analysis. Use it for GetYourGuide data extraction workflows where you need API access, scheduling, integrations, and export formats through [Apify](https://apify.com/). ### What can GetYourGuide Tours & Activities Scraper do? - Search GetYourGuide by city, destination, attraction, or activity keyword. - Accept direct GetYourGuide activity URLs, search pages, or city pages through `startUrls`. - Extract titles, descriptions, prices, currencies, ratings, review counts, durations, images, highlights, and cancellation policies. - Return live public data from GetYourGuide pages at run time. - Run on demand or on a recurring schedule with [Apify schedules](https://docs.apify.com/platform/schedules). - Send results to the [Apify API](https://docs.apify.com/api/v2), webhooks, and [Apify integrations](https://apify.com/integrations). ### What data can you extract from GetYourGuide tours? | Field | Description | |-------|-------------| | `id` | GetYourGuide activity ID parsed from the activity URL or page data | | `url` | Canonical GetYourGuide activity URL | | `title` | Activity title | | `shortDescription` | Marketing description from the activity page | | `city` | City where the activity takes place when available | | `country` | Country where the activity takes place when available | | `price` | Starting price shown for the current request locale/currency | | `currency` | Currency code returned by GetYourGuide, such as `USD`, `EUR`, or `MYR` | | `rating` | Average star rating from 0 to 5 | | `reviewCount` | Number of user reviews | | `duration` | Human-readable duration | | `category` | Activity category or inferred category, such as `guidedTour` or `ticket` | | `images` | Activity image URLs | | `highlights` | Bullet-point highlights from the activity page | | `cancellationPolicy` | Cancellation policy summary | | `scrapedAt` | ISO-8601 UTC timestamp | ### How to scrape GetYourGuide tours and activities 1. Open [GetYourGuide Tours & Activities Scraper](https://apify.com/parsebird/getyourguide-scraper) on Apify. 2. Enter a `query`, for example `rome`, `paris`, `eiffel tower`, or `food tour`. 3. Or add `startUrls` with GetYourGuide activity pages, search result pages, or city pages. 4. Set `maxItems` from `1` to `500`. 5. Run the actor and open the dataset. 6. Export the results as JSON, CSV, Excel, or connect them to your workflow through the Apify API. ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `query` | string | No | `rome` | Search query: city, destination, attraction, or activity keyword. Ignored when `startUrls` are provided | | `startUrls` | array | No | Prefilled examples | Direct GetYourGuide activity URLs, search pages, or city pages. Overrides `query` | | `maxItems` | integer | No | `3` | Maximum activities to return, from 1 to 500 | | `proxyConfiguration` | object | No | Apify Proxy enabled | Optional proxy settings if GetYourGuide rate-limits or blocks direct requests | ### Input / Output Example input: ```json { "query": "rome", "maxItems": 5 } ``` Example with start URLs: ```json { "startUrls": [ "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "https://www.getyourguide.com/s/?q=paris" ], "maxItems": 10 } ``` Example output: ```json { "type": "gyg_activity", "id": "217332", "url": "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "title": "Rome: Colosseum Arena Floor, Palatine & Forum Guided Tour", "shortDescription": "Experience special access to the Colosseum, Roman Forum, and Palatine Hill on a guided tour...", "city": "Rome", "country": "Italy", "price": 190, "currency": "MYR", "rating": 4.523653473661532, "reviewCount": 26094, "duration": "2.5 - 3 hours", "category": "guidedTour", "language": "en-US", "images": ["https://cdn.getyourguide.com/img/tour/94228a891b57dd5ac3f35040d77c0d5045f72c51aaf096f868ed50367e406c22.jpg/53.jpg"], "highlights": ["Enter the Colosseum like a gladiator and step onto the arena floor"], "cancellationPolicy": "Free cancellation Cancel up to 24 hours in advance for a full refund", "scrapedAt": "2026-07-19T08:30:00Z" } ``` Download results in JSON, CSV, Excel, HTML, XML, or RSS from the Apify dataset. ### Python API example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("parsebird/getyourguide-scraper").call(run_input={ "query": "rome", "maxItems": 5, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### JavaScript API example ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('parsebird/getyourguide-scraper').call({ startUrls: [ 'https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/', 'https://www.getyourguide.com/s/?q=paris', ], maxItems: 10, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` See Apify's official [Python client](https://docs.apify.com/api/client/python/) and [JavaScript client](https://docs.apify.com/api/client/js/) documentation for more options. ### How much does it cost to scrape GetYourGuide tours? **What is the price per GetYourGuide activity?** | Event | Free, Bronze, Silver | Gold | |-------|----------------------|------| | `activity-scraped` | $0.00299 per activity (**$2.99 / 1,000**) | $0.00259 per activity (**$2.59 / 1,000**) | Each `activity-scraped` event means one GetYourGuide activity was extracted and pushed to the dataset. A run with 1,000 activities costs $2.99 on Free, Bronze, and Silver plans, or $2.59 on Gold. Apify free trial credits may cover test runs where applicable. ### Use cases - Compare GetYourGuide tour prices, ratings, and review counts across destinations. - Build travel market research datasets for cities, attractions, or activity categories. - Monitor competitor tour listings and pricing changes. - Enrich travel guides, affiliate content, or internal dashboards with activity metadata. - Feed GetYourGuide activity data into spreadsheets, BI tools, databases, or automation workflows. ### How it works 1. The actor validates `query`, `startUrls`, and `maxItems`. 2. For search or city pages, it collects public GetYourGuide activity links from result cards. 3. For each activity URL, it fetches the public detail page and extracts structured Product data. 4. It normalizes fields into a flat `gyg_activity` record. 5. It pushes each activity to the default Apify dataset and charges one PPE event per saved activity on the Apify platform. ### Is it legal to scrape GetYourGuide? **Is scraping GetYourGuide tours and activities legal?** Scraping publicly available web data is generally allowed in many jurisdictions, but you should review GetYourGuide's terms, avoid collecting private or sensitive information, and make sure your use case complies with applicable laws. For more background, read Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/). ### Other GetYourGuide scrapers / Related Actors | Actor | Status | Best for | |-------|--------|----------| | [GetYourGuide Tours & Activities Scraper](https://apify.com/parsebird/getyourguide-scraper) | Available | Tours, activities, prices, ratings, images, highlights, and durations | | [GetYourGuide Review Scraper](https://apify.com/parsebird/getyourguide-review-scraper) | Available | Product reviews, ratings, authors, dates, and owner responses | More ParseBird actors: - [Pinterest Search Scraper](https://apify.com/parsebird/pinterest-search-scraper) - Extract structured Pinterest search result data. - [YouTube Search Scraper](https://apify.com/parsebird/youtube-search-scraper) - Extract structured YouTube search results. - [Product Hunt Scraper](https://apify.com/parsebird/product-hunt-scraper) - Scrape product launches and maker data. - [Unsplash Image Scraper](https://apify.com/parsebird/unsplash-image-scraper) - Collect image search data from Unsplash. ### FAQ **Can I use this as a GetYourGuide scraper API?** Yes. Start runs and fetch datasets through the Apify API, Python client, JavaScript client, webhooks, or integrations. **Can I scrape a single GetYourGuide activity page?** Yes. Add the activity URL to `startUrls`. The actor returns one enriched activity record for that page. **Can I scrape GetYourGuide search pages or city pages?** Yes. Add a search URL such as `https://www.getyourguide.com/s/?q=paris` or a GetYourGuide city page to `startUrls`. **Why does the currency differ from the sample competitor output?** GetYourGuide returns pricing for the request locale and region. The actor reports the currency code returned by the source page. **Does this actor need cookies or login?** No. It is designed for public GetYourGuide pages and does not use private GetYourGuide partner API credentials. **Where can I report issues or request fields?** Open the Issues tab on the actor page and include your input example, run ID, and the fields you expected. # Actor input Schema ## `query` (type: `string`): Enter a city, destination, attraction, or activity keyword. Ignored when Start URLs are provided. ## `startUrls` (type: `array`): Add direct GetYourGuide activity URLs, search URLs, or city pages. These override Query when provided. ## `maxItems` (type: `integer`): Maximum number of activities to return. ## `proxyConfiguration` (type: `object`): Use Apify Proxy if GetYourGuide rate-limits or blocks direct requests. ## Actor input object example ```json { "query": "rome", "startUrls": [ "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "https://www.getyourguide.com/s/?q=paris" ], "maxItems": 1, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "rome", "startUrls": [ "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "https://www.getyourguide.com/s/?q=paris" ], "maxItems": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "rome", "startUrls": [ "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "https://www.getyourguide.com/s/?q=paris", ], "maxItems": 1, } # Run the Actor and wait for it to finish run = client.actor("parsebird/getyourguide-scraper").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 '{ "query": "rome", "startUrls": [ "https://www.getyourguide.com/rome-l33/rome-colosseum-arena-floor-palatine-forum-guided-tour-t217332/", "https://www.getyourguide.com/s/?q=paris" ], "maxItems": 1 }' | apify call parsebird/getyourguide-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/getyourguide-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GetYourGuide Tours & Activities Scraper", "description": "Scrape GetYourGuide tours and activities by query or URL. Extract titles, prices, ratings, reviews, images, highlights, durations, and cancellation policies. Export JSON, CSV, Excel.", "version": "1.0", "x-build-id": "zw4Q1L4rpof6wAsbu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~getyourguide-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-getyourguide-scraper", "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/parsebird~getyourguide-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-getyourguide-scraper", "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/parsebird~getyourguide-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-getyourguide-scraper", "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": { "query": { "title": "Query", "type": "string", "description": "Enter a city, destination, attraction, or activity keyword. Ignored when Start URLs are provided.", "default": "rome" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Add direct GetYourGuide activity URLs, search URLs, or city pages. These override Query when provided.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of activities to return.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify Proxy if GetYourGuide rate-limits or blocks direct requests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```