JSON POST request example
POST to https://api.litescrape.com/api/booking/rooms with Content-Type: application/json and your Authorization: Bearer header.
{
"checkin": "2027-01-14",
"checkout": "2027-01-17",
"adults": 2,
"rooms": 1,
"currency": "EUR",
"language": "en-us",
"url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html"
}// request reference
Booking.com Rooms parameters
Send query parameters with GET /api/booking/rooms. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the Litescrape OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Property and stay
checkinCheck-in date in YYYY-MM-DD format.
Type string · GET query or POST JSON
Example / input hint: 2027-01-14
- Pattern: ^\d{4}-\d{2}-\d{2}$
checkoutCheck-out date in YYYY-MM-DD format.
Type string · GET query or POST JSON
Example / input hint: 2027-01-16
- Check-out must be later than check-in, with a stay of at most 30 nights.
- Pattern: ^\d{4}-\d{2}-\d{2}$
adultsNumber of adults.
Type integer · GET query or POST JSON · Default 2
Example / input hint: 2
- Minimum: 1
- Maximum: 30
childrenComma-separated ages of children, from 0 to 17.
Type string · GET query or POST JSON
Example / input hint: 4,9
- Include one age for each child, with at most 10 children.
- Maximum characters: 100
roomsNumber of rooms.
Type integer · GET query or POST JSON · Default 1
Example / input hint: 1
- Minimum: 1
- Maximum: 30
currencyCurrency for accommodation prices.
Type string · GET query or POST JSON · Default USD
Example / input hint: USD
AUDBRLCADCHFCNYCZKDKKEURGBPHKDHUFINRJPYKRWMXNNOKNZDPLNRONSEKSGDTHBTRYUSDZARurlBooking.com property URL, such as the url returned by accommodation search.
Type string · GET query or POST JSON
Example / input hint: https://www.booking.com/hotel/gb/the-langham.html
- Use a property URL with a country and hotel name, such as /hotel/gb/the-langham.html.
- Each offer prices one room for the full stay. Check occupancy and matches_requested_group before treating it as a price for the complete guest group.
- Minimum characters: 1
- Maximum characters: 4096
Language
languageLanguage for accommodation results.
Type string · GET query or POST JSON · Default en-us
Example / input hint: en-us
en-usen-gbde-dees-esfr-frit-itnl-nlpt-brja-jpko-krpl-plru-rutr-trzh-cn// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_parameters, property_id, url, room_types, offers, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_parameters": {
"checkin": "2027-01-14",
"checkout": "2027-01-17",
"adults": 2,
"children": null,
"rooms": 1,
"currency": "EUR",
"language": "en-us",
"url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html"
},
"property_id": "426368",
"url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html",
"room_types": [
{
"room_id": "42636801",
"name": "Standard Double Room",
"size": "17",
"size_unit": "m2",
"capacity": 2,
"beds": [
{
"type_id": null,
"description": "LARGE_DOUBLE_BED",
"count": 1
}
],
"facilities": [
"Shower",
"Toilet",
"Towels",
"Hairdryer",
"Toilet paper",
"Air conditioning",
"Safety deposit box",
"Streaming service (like Netflix)",
"Hardwood or parquet floors",
"Linens",
"Socket near the bed",
"Desk",
"Seating area",
"Soundproofing",
"TV",
"Telephone",
"Ironing facilities",
"Satellite channels",
"Tea/Coffee maker",
"Iron",
"Radio",
"Interconnected room(s) available",
"Heating",
"Flat-screen TV",
"Electric kettle",
"Wake-up service",
"Alarm clock",
"Upper floors accessible by elevator",
"Clothes rack"
],
"image_urls": [
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/884729996.jpg?k=dee0aa7436c5fcc0b650ff5b57c8736f4e6f49a7e353d73a4fa8cb544aa0d1de&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/750471983.jpg?k=5a0d0fa7951f47d2d5741a647bfb1c42704649103ab9f09d02071edd7ade484d&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/776769292.jpg?k=5c793738586b16649b31aa1dc04781b83641f034714e74b184208656b4503b1a&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/846270063.jpg?k=ed22b0b814c0eddbe9d0ce4be457d2d6c036f31baadf8f745d3368be7d5bb3b0&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/750471988.jpg?k=eb928138784adf4744769b0c27df5bb3a80a273f779ec5adaa30f34b23cc3922&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/884730002.jpg?k=edae3418f786a1c653bd1680c44f460c683e28473f572ba2cde96ec378594982&o=",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/590354116.jpg?k=b908060ace57e9ad3b45190f1a6667e840b69384a942757abde8ec81f8310ed6&o="
]
}
],
"offers": [
{
"offer_id": "42636801_94463129_2_42_0",
"room_id": "42636801",
"room_name": "Standard Double Room",
"capacity": 2,
"occupancy": 2,
"matches_requested_group": true,
"room_count": 1,
"price": {
"total": 325.041801036517,
"currency": "EUR",
"price_per_night": 108.347267012172,
"price_before_discount": null,
"discounts": [],
"tax_breakdown": [
{
"name": "20 % VAT",
"type_id": null,
"amount": 65.0084082122829,
"currency": "EUR",
"included": false
}
],
"taxes_and_fees": 65.008408212283,
"taxes_and_fees_included": false,
"completeness": "unknown"
},
"rate_terms": {
"free_cancellation": false,
"cancellation_deadline": null,
"cancellation_text": "Non-refundable",
"no_prepayment": null,
"prepayment_text": "Pay online",
"meal_plan": "BREAKFAST_EXCLUDED_LUNCH_EXCLUDED_DINNER_EXCLUDED"
},
"cancellation_type": "non_refundable",
"booking_url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html?checkin=2027-01-14&checkout=2027-01-17&group_adults=2&no_rooms=1&group_children=0&selected_currency=EUR&lang=en-us&highlighted_blocks=42636801_94463129_2_42_0"
},
{
"offer_id": "42636801_382239420_2_42_0",
"room_id": "42636801",
"room_name": "Standard Double Room",
"capacity": 2,
"occupancy": 2,
"matches_requested_group": true,
"room_count": 1,
"price": {
"total": 407.052437862283,
"currency": "EUR",
"price_per_night": 135.684145954094,
"price_before_discount": null,
"discounts": [],
"tax_breakdown": [
{
"name": "20 % VAT",
"type_id": null,
"amount": 81.4104395653169,
"currency": "EUR",
"included": false
}
],
"taxes_and_fees": 81.410439565317,
"taxes_and_fees_included": false,
"completeness": "unknown"
},
"rate_terms": {
"free_cancellation": true,
"cancellation_deadline": "January 13, 2027",
"cancellation_text": "Free cancellation before January 13, 2027",
"no_prepayment": true,
"prepayment_text": "No prepayment needed – pay at the property",
"meal_plan": "BREAKFAST_EXCLUDED_LUNCH_EXCLUDED_DINNER_EXCLUDED"
},
"cancellation_type": "free_cancellation",
"booking_url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html?checkin=2027-01-14&checkout=2027-01-17&group_adults=2&no_rooms=1&group_children=0&selected_currency=EUR&lang=en-us&highlighted_blocks=42636801_382239420_2_42_0"
}
],
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}