GetYourGuide Activity Pricing & Highlights Extractor

Turn GetYourGuide into a structured activity feed. Search a city, landmark, or activity phrase, or point the actor at GetYourGuide search, destination, category, or activity URLs, and receive pricing, ratings, highlights, inclusions, meeting points, cancellation terms, and supplier details for every tour you collect.

What it does

• Keyword search — one query per item (rome, eiffel tower, food tour paris) with the site's own filters and sort orders.
• URL and ID mode — accepts search pages, destination/attraction pages, category pages, activity pages, and bare activity IDs (631866 / t631866).
• Pagination — follows the listing's "show more" data until the source stops returning activities (up to 50 pages, 24 per page, per query).
• Optional detail enrichment — opens each activity for full descriptions, highlights, includes/excludes, meeting point + coordinates, cancellation policy, supplier, guides, itinerary, and reviews.
• Cookieless — no login, cookies, or API key required. Requests use GetYourGuide's public SDUI JSON and page data directly.

Output per activity

Identity and place: type, id, url, title, shortDescription, description, city, citySlug, region, country, latitude, longitude, meetingPoint.

Commercial: price, originalPrice, currency, discountPercent, pricingType, rating, reviewCount, cancellationPolicy, freeCancellation, supplierName.

Practical detail: duration, category, activityType, guideLanguages, images, highlights, whatIncluded, whatExcluded, goodToKnow, whatToBring, notAllowed, notSuitableFor, itinerary, bookingOptions, maxGroupSize, minAge, badges, availability, nextAvailable, recentBookings, reviewSummary, reviews, breadcrumbs.

Booking flags: skipTheLine, mobileTicket, instantConfirmation, pickupIncluded, wheelchairAccessible, smallGroup, privateTour, liveGuide.

Run metadata: searchQuery, sourceUrl, rank, scrapedAt.

A field GetYourGuide does not publish for an activity is omitted, never returned as null or an empty string.

Input

Field	Type	Default	Purpose
searchQueries	array	["rome"]	Cities, landmarks, or activity keywords.
startUrls	array	–	GetYourGuide search, destination, category, or activity URLs, or bare IDs.
activityIds	array	–	Direct activity IDs.
maxItems	integer	30	Global cap across all inputs (1–2000).
includeDetails	boolean	true	Open detail pages for the full field set.
maxReviews	integer	0	Recent reviews per activity (0–50).
currency	select	USD	Currency for prices.
language	select	English	Language of titles and descriptions.
sortBy	select	popularity	Popularity, rating, price ascending, or price descending.
minRating	select	any	3.0+, 3.5+, 4.0+, or 4.5+.
priceMin / priceMax	integer	0	Price range; 0 means unbounded.
dateFrom / dateTo	date	–	Only activities available in the date range.
startTime	array	–	Morning, afternoon, or evening.
durations	array	–	Up to 3h, 3–5h, 5–7h, full day, or 2–5+ days.
features	array	–	Private, skip the line, small group, wheelchair, pickup, or GetYourGuide Originals.
guideLanguages	array	–	Two-letter guide-language codes.
interests / places / departsFrom	array	–	Advanced GetYourGuide filter IDs copied from a search URL.

Example: search with filters

{
    "searchQueries": ["rome"],
    "maxItems": 20,
    "includeDetails": true,
    "sortBy": "rating",
    "minRating": "4.5",
    "features": ["skip_the_line"],
    "currency": "EUR",
    "language": "en"
}

Example: URLs and an ID

{
    "startUrls": [
        "https://www.getyourguide.com/rome-l33/",
        "https://www.getyourguide.com/s/?q=eiffel+tower&services=stl"
    ],
    "activityIds": ["631866"],
    "maxItems": 15,
    "includeDetails": true
}

Modes and pagination

1. Direct IDs / activity URLs — one detail-page fetch per activity.
2. Search queries — the actor calls GetYourGuide's search-result blocks endpoint, reads activity_card objects, and follows the returned loadMore payload page after page.
3. Destination / attraction URLs — same pagination against the destination's main activities section.
4. Category URLs — same pagination scoped to the category ID in the URL.

Each result page contains 24 activities. The actor stops at maxItems, after 50 pages, or when the source returns no new activities — whichever comes first. The source's own reported result count is logged, so a page cap is visible rather than silent.

Legacy inputs

Saved tasks that send the old query key still work: the actor maps query onto searchQueries in code. startUrls, maxItems, and bare activity IDs keep their original meaning. The old proxyConfiguration field is accepted but ignored — no proxy setup is needed.

Limits and honest notes

• GetYourGuide caps listing pagination at 50 pages (24 rows each) per query/listing. For deeper coverage, partition by category, date range, price bucket, or sub-destination.
• Some activities do not publish a discount, supplier rating, group size, age limit, or meeting point. Those fields are omitted for that row.
• Detail enrichment costs one page fetch per activity; turn includeDetails off for the cheapest, fastest listing-only runs.
• Filters are applied by GetYourGuide's own search backend. Filter values that the site does not recognize are ignored rather than guessed.

Sentinels

If a run returns no real activities, the dataset gets one explanatory record instead of an empty dataset:

• gyg_no_results — the inputs produced no matching activities.
• gyg_blocked — GetYourGuide rejected every request path (direct, browser-cookied, and last-resort proxy).

Sentinels include the attempted queries/URLs, a reason, and scrapedAt.

FAQ

Do I need cookies, a login, or an API key? No. The actor reads publicly visible GetYourGuide data.

Do I need to configure a proxy? No. Direct requests are tried first. If a container IP is challenged, the actor handles the fallback internally.

Why is a field missing on one activity but present on another? GetYourGuide only publishes some fields for some activities. Omit-empty output keeps the dataset honest.

Can I mix searches, URLs, and IDs? Yes. All inputs are processed in order and deduplicated by activity ID.

Is this affiliated with GetYourGuide? No. This is an independent actor that reads publicly available pages; it is not operated by or affiliated with GetYourGuide.