What is HBS?
HBS stands for Hotel Booking Scraper. In the hotels sector, you must set up a method to share with us booking and cancellation reports. These reports help both you and us track booking performance and are prerequisites for onboarding as an Automated Bidding Partner.
What do we need from you?
Set up a method for us to access the reports via S/FTP, API, S3, GCP, or a static download link.
Use supported file formats: CSV, ORC, JSON, or XML.
Include the required columns (data).
Keep records in the reports for the past 60 days, with a minimum of 7 days for us to consume
For bookings reports
field name | Desc | Required |
|---|---|---|
redirect_id | usually, it's redirectId from the report | Yes |
status | booking status: (if it's booking or cancellation). Please share us the full list of statuses if there are more than the two mentioned here) | Yes |
booking reference | the unique booking reference id, also known as order ID | Yes |
booking datetime | DateTime of booking | Yes |
check-in date | check-in date | Optional |
checkout date | checkout date | Yes/Optional when deal_type is pay_on_checkout: 'checkout' is required |
booking price | booking total price amount | Yes |
booking price currency | booking price currency | Yes |
nights | nights of stay | Optional |
hotel ID | partner hotelid | Optional |
hotel name | partner hotel name | Optional |
price margin | Skyscanner revenue/margin | Yes/Optional when the model type is rs(Revenue is calculated by applying a percentage to the partner’s margin): 'price_margin_currency' & 'price_margin' are required or have 'margin' calculation formula |
For Cancellations Report
| Field | Description | Required? |
|---|---|---|
status (a flag that tells us that this is a cancellation) | status that tells us if this is a booking or cancellation | mandatory |
booking datetime | DateTime of booking | mandatory |
redirect id | The redirect ID that we share by appending the parameter “skyscanner_redirectid” on the deeplink. | mandatory |
booking reference | the unique booking reference id, also known as order ID | mandatory |
property id (hotelid) | partner hotel id | optional |
check in | check-in date | optional |
check out | checkout date | optional |
booking price |
| optional |
booking price currency |
| optional |
What is the process?
After confirming commercial details, a Skyscanner Partner Services member will contact you to complete a survey. Complete surveys promptly to avoid delays.
If you haven't already, please provide the Bookings Report and Cancellations Report using the supported methods. If you cannot provide actual reports, share a test report. Note that once live, you must send the exact data from the test report. If it fails, we will pause the integration until fixes are applied.
A Partner Services member will verify the data and ensure requirements are met.
Then, a request will be sent to the HBS engineer for implementation. Refer to the note in step 2.
If you have questions, please contact partnersupport@skyscanner.net.