Search Booking.com for a destination and dates, and collect each property’s price, rating, review count, amenities, and breakfast info for the stay you specify. Output fields: name, price, pricePerNig
Search Booking.com for a destination and dates, and collect each property's price, rating, review count, amenities, and breakfast info for the stay you specify.
nimbryxo-studio~booking-com-hotel-price-and-amenity-search-scraper)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonUse this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
name: Hotelprice: Stay totalpricePerNight: Per nightcurrency: Currencyrating: RatingreviewCount: ReviewsreviewWord: Score wordstars: StarspropertyType: Typecity: Citycountry: CountryfreeCancellation: Free cancellationbreakfastIncluded: BreakfasttopAmenities: Top amenitiesurl: URLAll 45 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| mode | string | no | search | Search a destination, or load specific Booking.com hotel URLs. |
| destination | string | no | | City, region or landmark to search, e.g. Paris, New York or Tokyo. Required in search mode. |
| startUrls | array | no | [] | Booking.com hotel page URLs, used in details mode. Copy links from a search result or your browser. |
| checkIn | string | no | | Check-in date as YYYY-MM-DD. Leave empty to use tomorrow. |
| checkOut | string | no | | Check-out date as YYYY-MM-DD. Leave empty to use a 3-night stay. |
| adults | integer | no | 2 | Number of adult guests. |
| rooms | integer | no | 1 | Number of rooms needed. |
| propertyType | string | no | all | Keep only one Booking.com property type, or search all types. |
| minReviewScore | number | no | 0 | Minimum guest score from 0 to 10. The actor applies Booking.com's score filter and then keeps only properties at or above this exact score. |
| stars | string | no | 0 | Keep only properties with this star rating, or any star rating. |
| freeCancellation | boolean | no | false | Return properties with at least one free-cancellation rate. |
| breakfast | boolean | no | false | Return properties with a breakfast-included rate. |
| pool | boolean | no | false | Return properties that have a swimming pool. |
| minPrice | number | no | | Optional lower bound for the nightly price in the chosen currency. |
7 more optional fields on the Actor's Input tab.
Example:
{
"mode": "search",
"startUrls": [],
"adults": 2,
"rooms": 1,
"propertyType": "all",
"minReviewScore": 0,
"stars": "0",
"freeCancellation": false,
"breakfast": false,
"pool": false,
"currency": "USD",
"language": "en-us",
"maxItems": 3,
"includeRooms": true,
"includeFullAmenities": false
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~booking-com-hotel-price-and-amenity-search-scraper/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~booking-com-hotel-price-and-amenity-search-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.