Booking.com Things-to-Do Price & Rating Snapshot

Turn a destination into a clean table of bookable tours, tickets and activities: price, currency, rating on both Booking's 5-point scale and a familiar 0–10 scale, review counts, duration, cancellation policy, categories, photos and addresses. Search any city, or paste product URLs/IDs to pull one record per activity.

No account, no cookies and no proxy setup are needed. The actor reads Booking.com's public attractions data directly and returns one JSON record per activity.

What this actor does

• Five modes - search a destination, fetch product details, check availability, read reviews, or list the destination catalogue
• Any destination - 30 popular cities plus custom city/country input
• Prices and ratings - public and discounted prices, Booking's 0-5 rating plus a 0-10 compatibility field, and review counts
• Activity detail - duration, cancellation policy, categories, photos, addresses, guide languages, inclusions and supplier
• Filters - rating, free cancellation, skip-the-line, wheelchair access, time of day, guide language, category, price and review count
• Optional enrichment - reviews, availability calendars and full product details
• Empty fields are omitted - never null, blank or placeholder values

Modes

Mode	What it returns
search	Activities for a destination, with optional filters and pagination (default)
productDetails	Full records for specific product IDs or URLs
availability	Time slots for one date, plus an optional available-dates calendar
reviews	Guest reviews for specific products, with sorting and a per-product cap
destinations	The Booking.com city catalogue with ufi, country and product count

Input

Field	Type	Default	Description
mode	select	search	One of the five modes above
destination	select	fr/paris	30 popular cities or custom
customCity	text	–	City name or slug, e.g. kuala-lumpur
customCountry	text	–	Two-letter code or country name, e.g. my
query	text	–	Free-text search inside the destination
sortBy	select	trending	trending, lowest_price, highest_weighted_rating
minRating	select	any	4.5, 4.0, 3.5 or 3.0 on Booking's 5-point scale
freeCancellationOnly	boolean	false	Keep free-cancellation activities
skipTheLineOnly	boolean	false	Keep skip-the-line activities
wheelchairAccessibleOnly	boolean	false	Keep wheelchair-accessible activities
timeOfDay	select	any	Morning, afternoon or evening start
guideLanguage	select	any	Guide language filter
category	select	any	Tours, museums, nature, entertainment, food, services
minPrice / maxPrice	number	–	Representative-price bounds
minReviews	integer	–	Minimum guest-review count
startDate / endDate	text	–	Availability window in YYYY-MM-DD
productIds	string list	[]	Booking product IDs or product URLs
productUrls	URL list	[]	Product URLs (merged with productIds)
availabilityDate	text	tomorrow	Date for availability mode
includeCalendar	boolean	false	Fetch available dates and cheapest-price groups
includeReviews	boolean	false	Attach reviews to each product
reviewSortBy	select	most_relevant	Review order
maxReviewsPerProduct	integer	10	1–50
includeAvailability	boolean	false	Attach time slots to each product
includeDetails	boolean	false	Fetch full details (all photos, inclusions, accessibility) per search result
maxResults	integer	50	1–1,000; the daily prefill uses 3
language	select	en	Content language for names and descriptions
currency	select	EUR	Currency for representative prices

Examples

Smallest daily run:

{ "destination": "fr/paris", "maxResults": 3 }

Filtered city search:

{
  "mode": "search",
  "destination": "it/rome",
  "minRating": "4.5",
  "freeCancellationOnly": true,
  "sortBy": "lowest_price",
  "maxResults": 40
}

Custom city:

{
  "mode": "search",
  "destination": "custom",
  "customCity": "kuala-lumpur",
  "customCountry": "my",
  "maxResults": 20
}

Product details by URL or ID:

{
  "mode": "productDetails",
  "productIds": [
    "PRe4kSVWXdrD",
    "https://www.booking.com/attractions/fr/pre4ksvwxdrd-seine-river-sightseeing-cruise.html"
  ]
}

Availability for one date, plus the calendar:

{
  "mode": "availability",
  "productIds": ["PRe4kSVWXdrD"],
  "availabilityDate": "2026-12-15",
  "startDate": "2026-12-01",
  "endDate": "2026-12-31",
  "includeCalendar": true
}

Output per record type

Every record includes the fields the source provides; empty values are omitted, never sentinel-filled.

• Identity: recordType, id, name, slug, url, sourceUrl, city, cityName, destinationUfi, destinationName, destinationCountry
• Price: price, currency, pricePublicAmount, priceDiscountAmount, priceDiscountPercentage
• Ratings: rating (0–10), ratingOutOf5, ratingScale, reviewCount, reviewCountAll, photosCount, ratingCategoryBreakdown
• Duration: duration, durationValue, durationMin, durationMax
• Policy: freeCancellation, cancellationPolicy, availableFrom, bookingWindowDays, isBookable
• Taxonomy: type, categories, tags, labels, primaryLabel, flags, highlights, itinerary
• Copy: shortDescription, description, additionalInfo; whatsIncluded, notIncluded, uniqueSellingPoints and accessibility are lists
• Languages: guideLanguages, audioLanguages
• Media: photoUrl, photoCaption, photos
• Location: address, countryCode, countryName, postalCode, latitude, longitude, locationType, locationInstructions, departurePoint, meetingPoint
• Commerce: supplier, externalSellerUrl, poweredBy, operatedBy, timeZone
• Optional: reviews, reviewSummary, timeSlots, availabilityDate, availableDates, cheapestPrices
• scrapedAt

Rating scales: Booking's attractions API reports 0–5. This actor keeps the original rating field at 0–10 for compatibility, and also emits ratingOutOf5 and ratingScale, so you can use either without guessing.

Use cases

• Travel planning - compare tours, tickets and activities across a destination
• Price monitoring - track public and discounted activity prices over time
• Market research - map a city's attraction supply, categories and ratings
• Review analysis - export guest reviews for sentiment and complaint research
• Availability checks - inspect time slots and calendars for specific dates

FAQ

Do I need a Booking.com account? No. The actor reads public listing data and needs no login, cookie or API key.

Do I need a proxy? No. It connects directly and switches to a working connection automatically only if one is needed. No proxy setup is required.

Can I use any city? Yes. Pick one of the 30 popular cities or set destination to custom and enter a city name and country. Cities with no attractions inventory return a clean empty result with a status message.

Why are some fields missing on a record? Booking.com does not publish every detail for every activity. The actor omits fields the source does not have instead of writing 0, "N/A" or an empty string.

Why is category applied after fetching? Booking's category parameter is broader than its own product taxonomy. The actor fetches the page, then verifies each product's own type/categories/tags, so a category filter is accurate rather than approximate.

How many results can I get? maxResults supports up to 1,000. The source may have thousands of activities in a large city; the status message reports when the cap was reached.

How fresh is the data? Each run reads Booking.com live, so prices, ratings and availability reflect the request time.

Is this affiliated with Booking.com? No. This is an independent third-party actor that reads publicly available Booking.com pages and data. It is not affiliated with or endorsed by Booking.com.

Data source and limitations

The actor reads Booking.com's public attractions listing, product, review, availability and destination endpoints. There is no official free public API for this data; the official Booking.com Demand API is partner-only and requires credentials. This actor uses the same public web data a browser sees, with no account.

Known limits:

• Availability and review enrichment add one or more requests per product; they are off by default and off in the daily prefill.
• Category, price and minimum-review filters are verified after fetch because the source's server-side parameters are not strict.
• Some activities have no rating, duration or cancellation data because the source does not publish it.
• Availability is date-specific. A product with no time slots on the requested date may still be bookable on another date; use the calendar fields to see available dates.
• Large city catalogues can exceed 1,000 activities; raise maxResults or partition by category, date or price.