JSON POST request example
POST to https://api.litescrape.com/api/booking/detail 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 Property parameters
Send query parameters with GET /api/booking/detail. 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.
- Includes featured reviews and up to 10 guest questions.
- 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, 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": {
"property_id": "426368",
"name": "ibis London Blackfriars",
"url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html",
"description": "With free Wi-Fi throughout, a 24-hour reception and a 24-hour meal and drinks menu, the Ibis London Blackfriars offers modern rooms in central London. Just 5 minutes’ walk from Waterloo Station, the Tate Modern is within 10 minutes on foot.\n\nEach bedroom comes with an private bathroom and flat-screen TV, ironing board and kettle.\n\nCharlie's Corner restaurant at ibis London Blackfriars - Charlie is the barman who works in the corner of the hotel that's always buzzing with life and cool music. The bar is dedicated to craft beer, great coffee, delicious bites and where music and cool vibes come together. Share good times at Charlie's Corner!\n\nThe London Eye and Big Ben are within a 20-minute walk, while 10 minutes on the Jubilee line from Waterloo to Bond Street Tube Station provides access to the shops of Oxford Street.",
"address": "49 Blackfriars Road, Southwark, London, SE1 8NZ, United Kingdom",
"district": "Southwark, London",
"distance_from_center": "1 miles from downtown",
"public_transport_distance": "Southwark station is within 150 yards",
"location_score": 9.2,
"latitude": 51.5051831716537,
"longitude": null,
"star_rating": 3,
"review_score": 8.3,
"review_count": 6475,
"image_urls": [
"https://cf.bstatic.com/xdata/images/hotel/max500/889077857.jpg?k=a2b895c41f025e91a44fc8eac89a95290f2c38dee3e73ec9e486d2ae1169e1a2&o=",
"https://cf.bstatic.com/xdata/images/hotel/max500/934687356.jpg?k=74c366ecee9f18564cf0cc80a59c6b5c3ed2a9cd4260ebafd9f798b39fa4424a&o="
],
"amenities": [
"Air conditioning",
"Smoke-free property",
"Hardwood or parquet floors",
"Heating",
"Elevator",
"Family rooms",
"Ironing facilities",
"Facilities for disabled guests",
"Non-smoking rooms",
"Pet bowls",
"Daily housekeeping",
"Wake-up service",
"Fax/Photocopying",
"Express check-in/out",
"Dry cleaning",
"24-hour front desk",
"Private bathroom",
"Toilet",
"Hairdryer",
"Shower",
"Flat-screen TV",
"Wine/Champagne",
"Kids' meals",
"Special diet meals (on request)",
"Snack bar",
"Bar",
"Restaurant",
"Internet",
"Electric kettle",
"Desk",
"Alarm clock",
"Bathroom emergency cord",
"Toilet with grab rails",
"Invoice provided",
"Fire extinguishers",
"CCTV outside property",
"CCTV in common areas",
"Smoke alarms",
"Security alarm",
"Key card access",
"Safe",
"Face masks for guests available",
"Access to healthcare professionals",
"First aid kits available",
"Hand sanitizer in guest accommodation and common areas",
"Shared stationery (e.g. printed menus, magazines, pens, paper) removed",
"Staff follow all safety protocols as directed by local authorities",
"Screens or physical barriers between staff and guests in appropriate areas",
"Physical distancing rules followed",
"Cashless payment available",
"Contactless check-in/out",
"Guests have the option to cancel any cleaning services for their accommodation during their stay",
"Property cleaned by professional cleaning companies",
"Guest accommodation sealed after cleaning",
"Guest accommodation disinfected between stays",
"Linens, towels, and laundry washed in accordance with local authority guidelines",
"Use of cleaning chemicals that are effective against coronavirus",
"Delivered food covered securely",
"All plates, cutlery, glasses, and other tableware sanitized",
"Food can be delivered to guest accommodation",
"Physical distancing in dining areas",
"Wheelchair accessible"
],
"facility_groups": [
{
"group_id": 1,
"name": "General",
"facilities": [
"Air conditioning",
"Smoke-free property",
"Hardwood or parquet floors",
"Heating",
"Elevator",
"Family rooms",
"Ironing facilities",
"Facilities for disabled guests",
"Non-smoking rooms"
]
}
],
"room_types": [
{
"room_id": "42636801",
"name": "Standard Double Room",
"size": null,
"size_unit": null,
"capacity": null,
"beds": [
{
"type_id": 6,
"description": null,
"count": 1
}
],
"facilities": [
"Safety deposit box",
"Air conditioning",
"Iron",
"Ironing facilities",
"Heating",
"Interconnected room(s) available",
"Soundproofing",
"Hardwood or parquet floors",
"Wake-up service",
"Clothes rack",
"Socket near the bed",
"Shower",
"Hairdryer",
"Toilet",
"Private bathroom",
"Towels",
"Toilet paper",
"TV",
"Telephone",
"Radio",
"Satellite channels",
"Flat-screen TV",
"Streaming service (like Netflix)",
"Tea/Coffee maker",
"Electric kettle",
"Desk",
"Seating area",
"Alarm clock",
"Linens",
"Upper floors accessible by elevator"
],
"image_urls": []
}
],
"policies": {
"checkin_from": "3:00 PM",
"checkin_until": null,
"checkout_from": null,
"checkout_until": "12:00 PM",
"minimum_checkin_age": 18,
"pets_allowed": "YES",
"pets_charge": "CHARGES_MAY_APPLY",
"children_allowed": true,
"minimum_child_age": 0,
"cribs_allowed": true,
"extra_beds_allowed": false,
"child_rules": [
{
"age_from": 0,
"age_to": 11,
"bed_type": "EXISTING_BED",
"price": "£0",
"price_type": "FREE",
"price_mode": "PER_STAY"
},
{
"age_from": 0,
"age_to": 2,
"bed_type": "CRIB",
"price": "£0",
"price_type": "FREE",
"price_mode": "PER_NIGHT"
}
],
"damage_deposit": null,
"damage_deposit_amount": null,
"damage_deposit_currency": null,
"accepted_payment_methods": [
"American Express",
"Visa",
"Mastercard",
"Diners Club",
"JCB",
"Maestro",
"Discover",
"Debit card"
],
"cash_accepted": false
},
"rate_terms": {
"free_cancellation": true,
"cancellation_deadline": "2027-01-13T00:00:00Z",
"cancellation_text": null,
"no_prepayment": true,
"prepayment_text": null,
"meal_plan": null
},
"category_scores": [
{
"category": "hotel_wifi",
"traveller_type": "SOLO_TRAVELLER",
"score": 8.1,
"review_count": 126
},
{
"category": "hotel_paid_wifi",
"traveller_type": "SOLO_TRAVELLER",
"score": 6.5,
"review_count": 16
}
],
"featured_reviews": [
{
"review_id": "5360125685",
"author": "Andrea",
"author_country": "ca",
"score": 9,
"title": "It was a great location for a two day trip to London",
"positive": "The staff was very accommodating and pleasant. There is a train station close by, but I ended up using Waterloo station about nine minutes walk.",
"negative": null,
"language": "xu",
"traveller_type": "SOLO_TRAVELLER",
"room_name": "Standard Double Room"
}
],
"questions_and_answers": [
{
"question": "Hi we have a booking 4th October, we arrive into London round 11 am, do you have place for us to store our luggage?",
"answer": "Good morning\nYes, we have. We can store your luggage upon your arrival.\nBest regards, Front Office team",
"asked_on": "August 7, 2022",
"answered_on": "August 7, 2022",
"room_id": null
}
],
"checkin": "2027-01-14",
"checkout": "2027-01-17",
"adults": 2,
"children": null,
"rooms": 1,
"availability": "available",
"price": {
"total": 305,
"currency": "EUR",
"price_per_night": 101.763099464583,
"price_before_discount": 407.052397858334,
"discounts": [
{
"name": "Late Escape Deal",
"amount": 101.763099464583,
"currency": "EUR"
}
],
"tax_breakdown": [
{
"name": null,
"type_id": 21,
"amount": 61.0578596787501,
"currency": "EUR",
"included": true
}
],
"taxes_and_fees": 61.0578596787501,
"taxes_and_fees_included": false,
"completeness": "total"
},
"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"
},
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}