Search Booking.com hotels by location, dates and occupancy in one unified schema, with cross-OTA price comparison. Use for hotel discovery on Booking.com. Powered by StayingAPI.
Data & analysis
Dataify Booking Hotel Info
Try itCollect Booking Hotel Info data and return results
What it does
Collect structured Booking.com hotel records from a known Booking hotel or listing URL. Use for Booking hotel details or listings. Do not use for general hotel price discovery through Google Hotels.
The skill document
Dataify Booking Hotel Info
Use this skill to create Booking hotel information collection tasks through Dataify's builder endpoint.
Required Workflow
- Use the
booking_hotellist_by-urlspider when the user wants to collect Booking hotel information from one or more Booking URLs. - Check the local Python runtime before calling scripts. Prefer
python; usepython3if that is the available Python command. Require Python 3 or newer. Do not use version-specific commands such aspy -3.10. - Tell the user which parameters are required and what the defaults are. Ask whether any values should be changed.
- Ask whether the user wants to collect multiple parameter sets. If yes, collect multiple
spider_parametersobjects for the same spider ID. If the user already supplied multiple Booking URLs, treat that as a multiple-set request. - Before every real API call, show a Markdown confirmation table with the exact parameters that will be submitted. The table must use these columns:
Parameter,Current value,Default value,Required,Description. - If any dropdown fields are added in the future, show all available dropdown values in Markdown tables with exactly these columns:
Label,Value. This tool currently has no dropdown fields. - Ask the user whether any value should be changed. Do not call the API until the user explicitly confirms the table.
- Check for the Dataify API token only after parameter confirmation. Prefer a token explicitly provided by the user, then
DATAIFY_API_TOKENfrom the environment. - If no token is available, tell the user:
Missing Dataify API token. Provide a token, or log in/register atDataifyIf you already have one, openDataifyand copy the API TOKEN from the top-right area. - If the user provides a token and
DATAIFY_API_TOKENis not already saved locally, ask whether to save it asDATAIFY_API_TOKEN. Save it only after explicit consent and never echo the token back. - After the API call, report the collection task ID and status. Look for common response fields such as
task_id,taskId,id,status,data.task_id,data.id, ordata.status. Then remind the user to view task details in the official dashboard: Dataify
Parameter Preview
Use the preview helper whenever possible:
python scripts/preview_params.py --url "https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"
For multiple parameter sets, pass the exact JSON array:
python scripts/preview_params.py --parameters-json '[{"url":"https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"},{"url":"https://www.booking.com/hotel/us/example.en-gb.html"}]'
API Call
Use the call helper after confirmation and token handling:
python scripts/booking_hotellist.py --url "https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"
python scripts/booking_hotellist.py --parameters-json '[{"url":"https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"},{"url":"https://www.booking.com/hotel/us/example.en-gb.html"}]'
If the token was provided in the conversation instead of the environment, pass it with --token and do not expose it in user-facing output:
python scripts/booking_hotellist.py --token "USER_TOKEN" --url "https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"
Tool
| Mode | Spider ID | Required parameters | Default spider_parameters |
|---|---|---|---|
by-url | booking_hotellist_by-url | url | [{"url":"https://www.booking.com/hotel/gb/westlands-of-pitlochry.en-gb.html#tab-main"}] |
Every request also accepts file_name. If omitted, use {{TasksID}}.
Fixed Request Fields
Always submit to https://scraperapi.dataify.com/builder?platform=1 with:
| Field | Value |
|---|---|
spider_name | booking.com |
spider_id | booking_hotellist_by-url |
spider_parameters | JSON array of one or more parameter objects |
spider_errors | true |
file_name | User value, otherwise {{TasksID}} |
Send parameters as form data. Keep spider_parameters as a JSON string inside the form body.
Related skills
Search Google Hotels for hotel prices
Search Booking.com for a destination and stay with live nightly prices, pull one property in full with rooms and rate plans, and read guest reviews with the category breakdown. 3 endpoints, 1 credit each, structured JSON.
Collect Airbnb Builder data and return results
Read normalized Booking.com reviews for a listing, with native rating scales preserved. Use when a user wants ratings or guest feedback for a listing on Booking.com. Powered by StayingAPI.
Complete Booking.com toolkit — search, availability, listing detail, price, cross-OTA price comparison and reviews, all in one unified schema. Install this when an agent needs broad Booking.com coverage. Powered by StayingAPI.