Marketing Insight API - Booking.com

Get the Marketing insight reports from the booking.com

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/reporting.php

---

Attributes

---

hotelid alphanumeric (Required)

The unique property ID as assigned by the provider upon creation of the property.

---

channelhotelid alphanumeric (Required)

The unique property ID as assigned by the channel.

---

report alphanumeric (Required)

The name of the report.

---

Sample Request

{
"hotelid": "CRP1",
"channelhotelid": "123456999",
"report": "marketing_insight"
}

---

Response

Sample success response

{
"report_area": "New Plymouth",
"demand_data": [
{
"category_summary": "Most searches were looking for 8-30 days in the future",
"category_name": "book_window",
"stats": [
{
"key": "bookwindow_8_30",
"formatted_score": "20.93%",
"title": "8-30 days"
},
{
"key": "bookwindow_2_7",
"title": "2-7 days",
"formatted_score": "20.31%"
},
{
"title": "31-90 days",
"formatted_score": "18.58%",
"key": "bookwindow_31_90"
},
{
"formatted_score": "17.53%",
"title": "0-1 day",
"key": "bookwindow_0_1"
},
{
"key": "bookwindow_91",
"title": "91+ days",
"formatted_score": "16.56%"
},
{
"formatted_score": "6.09%",
"title": "No dates",
"key": "bookwindow_unknown"
}
],
"title": "Book window"
},
{
"category_summary": "Most searches were from couples",
"stats": [
{
"key": "traveller_couple",
"title": "Couple",
"formatted_score": "63.68%"
},
{
"formatted_score": "15.00%",
"title": "Family",
"key": "traveller_family"
},
{
"title": "Solo traveller",
"formatted_score": "11.19%",
"key": "traveller_solo"
},
{
"title": "Group",
"formatted_score": "10.13%",
"key": "traveller_group"
}
],
"category_name": "traveller_type",
"title": "Traveller type"
},
{
"title": "Domestic and international travellers",
"category_summary": "Most searches were made by domestic travellers",
"stats": [
{
"key": "origin_domestic",
"title": "Domestic",
"formatted_score": "67.41%"
},
{
"title": "International",
"formatted_score": "32.59%",
"key": "origin_international"
}
],
"category_name": "origin"
},
{
"category_summary": "Most searches were mobile searches",
"category_name": "device",
"stats": [
{
"title": "Mobile",
"formatted_score": "76.56%",
"key": "device_mobile"
},
{
"key": "device_web",
"formatted_score": "23.44%",
"title": "Desktop"
}
],
"title": "Device"
},
{
"category_summary": "Most searches were from New Zealand",
"stats": [
{
"formatted_score": "67.41%",
"title": "New Zealand",
"key": "nz"
},
{
"key": "au",
"title": "Australia",
"formatted_score": "7.68%"
},
{
"key": "us",
"formatted_score": "3.81%",
"title": "United States"
},
{
"title": "Germany",
"formatted_score": "3.27%",
"key": "de"
},
{
"title": "United Kingdom",
"formatted_score": "2.78%",
"key": "gb"
}
],
"category_name": "rank",
"title": "Top 5 countries"
},
{
"title": "Cancellation policy",
"category_summary": "Most guests staying in New Plymouth made free cancellation bookings",
"stats": [
{
"key": "policy_flexible",
"formatted_score": "60.06%",
"title": "Free cancellation"
},
{
"key": "policy_non_refundable",
"title": "Non-refundable",
"formatted_score": "34.97%"
},
{
"formatted_score": "4.97%",
"title": "Partially refundable",
"key": "policy_flexible_cost_to_cancel"
}
],
"category_name": "policy"
},
{
"stats": [
{
"title": "1 night",
"formatted_score": "53.83%",
"key": "1_day"
},
{
"key": "2_days",
"title": "2 nights",
"formatted_score": "27.98%"
},
{
"key": "3_7_days",
"formatted_score": "17.17%",
"title": "3-7 nights"
},
{
"title": "8-14 nights",
"formatted_score": "0.62%",
"key": "8_14_days"
},
{
"key": "15_plus_days",
"formatted_score": "0.41%",
"title": "15+ nights"
}
],
"category_name": "length_of_stay",
"category_summary": "Most searches were looking for a stay of 1 night",
"title": "Length of stay"
}
],
"report_date": "2024-02-07"
}

No hotelid provided

{
"Status": "Fail",
"Errors": {
"Code": "891",
"ShortText": "Bad Request"
}
}

In case of no channelhotelid or report provided

{
"Status": "Fail",
"Errors": {
"Code": "879",
"ShortText": "Something Went Wrong"
}
}