JSON POST request example
POST to https://api.litescrape.com/api/booking/search 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",
"destination": "London",
"page": 1,
"limit": 2
}// request reference
Booking.com Search parameters
Send query parameters with GET /api/booking/search. 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.
Stay and destination
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
AUDBRLCADCHFCNYCZKDKKEURGBPHKDHUFINRJPYKRWMXNNOKNZDPLNRONSEKSGDTHBTRYUSDZARdestinationDestination name, region, or property search term.
Type string · GET query or POST JSON
Example / input hint: Paris
- Use the city, region, or property name accepted by Booking.com.
- Minimum characters: 1
- Maximum characters: 200
Language and pagination
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-cnpageResults page to retrieve.
Type integer · GET query or POST JSON · Default 1
Example / input hint: 1
- Use pagination.next_page when present. A null pagination.has_more means another page was not confirmed.
- Minimum: 1
- Maximum: 10
limitMaximum accommodations to return from this page.
Type integer · GET query or POST JSON · Default 25
Example / input hint: 25
- Use limit=25 to retrieve every item on each page.
- Minimum: 1
- Maximum: 25
// 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, accommodations, pagination, 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",
"destination": "London",
"page": 1,
"limit": 2
},
"accommodations": [
{
"property_id": "426368",
"name": "ibis London Blackfriars",
"url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html",
"image_url": "https://cf.bstatic.com/xdata/images/hotel/square240/889077857.jpg?k=a2b895c41f025e91a44fc8eac89a95290f2c38dee3e73ec9e486d2ae1169e1a2&o=",
"location": "49 Blackfriars Road",
"latitude": 51.5051831716537,
"longitude": null,
"district": "Southwark, London",
"distance_from_center": "1 miles from downtown",
"public_transport_distance": "Southwark station is within 150 yards",
"location_score": null,
"rate_terms": {
"free_cancellation": true,
"cancellation_deadline": "2027-01-13T00:00:00Z",
"cancellation_text": null,
"no_prepayment": true,
"prepayment_text": null,
"meal_plan": null
},
"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": [],
"image_urls": []
}
],
"rating": 8.3,
"review_count": 6475,
"room_type": "Standard Double Room",
"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"
},
{
"property_id": "178835",
"name": "Montcalm Mayfair, Autograph Collection",
"url": "https://www.booking.com/hotel/gb/the-montcalm.html",
"image_url": "https://cf.bstatic.com/xdata/images/hotel/square240/861319655.jpg?k=5c8eeaad40eb47947f2140d45c4f404140ce2baa540a45c465c212701e3b6a7b&o=",
"location": "2, Wallenberg Place",
"latitude": 51.51524236,
"longitude": null,
"district": "Hyde Park",
"distance_from_center": "1.5 miles from downtown",
"public_transport_distance": "Marble Arch station is within 200 yards",
"location_score": 9.4,
"rate_terms": {
"free_cancellation": false,
"cancellation_deadline": null,
"cancellation_text": null,
"no_prepayment": false,
"prepayment_text": null,
"meal_plan": null
},
"room_types": [
{
"room_id": "17883554",
"name": "Studio",
"size": null,
"size_unit": null,
"capacity": null,
"beds": [
{
"type_id": 3,
"description": null,
"count": 1
}
],
"facilities": [],
"image_urls": []
}
],
"rating": 8.7,
"review_count": 201,
"room_type": "Studio",
"availability": "unknown",
"price": {
"total": 975,
"currency": "EUR",
"price_per_night": 306.706160779494,
"price_before_discount": null,
"discounts": [],
"tax_breakdown": [
{
"name": null,
"type_id": 21,
"amount": 184.023648461517,
"currency": "EUR",
"included": true
}
],
"taxes_and_fees": 184.023648461517,
"taxes_and_fees_included": false,
"completeness": "unknown"
},
"booking_url": "https://www.booking.com/hotel/gb/the-montcalm.html?checkin=2027-01-14&checkout=2027-01-17&group_adults=2&no_rooms=1&group_children=0&selected_currency=EUR&lang=en-us"
}
],
"pagination": {
"page": 1,
"has_more": true,
"next_page": 2,
"returned_count": 2
},
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}