JSON POST request example
POST to https://api.litescrape.com/api/google/hotels with Content-Type: application/json and your Authorization: Bearer header.
{
"destination": "London",
"checkin": "2027-01-14",
"checkout": "2027-01-17",
"adults": 2,
"rooms": 1,
"currency": "USD",
"language": "en-us"
}// request reference
Google Hotels parameters
Send query parameters with GET /api/google/hotels. 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.
Request parameters
destinationCity or region to search for accommodations.
Type string · GET query or POST JSON
Example / input hint: London
- Minimum characters: 1
- Maximum characters: 200
checkinCheck-in date in YYYY-MM-DD format.
Type string · GET query or POST JSON
Example / input hint: 2027-01-14
- Check-out must be later than check-in. Stays are limited to 30 nights.
checkoutCheck-out date in YYYY-MM-DD format.
Type string · GET query or POST JSON
Example / input hint: 2027-01-17
adultsNumber of adults.
Type integer · GET query or POST JSON · Default 2
Example / input hint: 2
- Adults and children combined cannot exceed six guests.
- Minimum: 1
- Maximum: 6
childrenComma-separated ages of children, from 0 to 17.
Type string · GET query or POST JSON
Example / input hint: 4,9
- Leave empty when traveling without children. Adults and children combined cannot exceed six guests.
- Maximum characters: 100
roomsNumber of rooms; only one room is supported.
Type integer · GET query or POST JSON · Default 1
Example / input hint: 1
- Minimum: 1
- Maximum: 1
currencyCurrency for hotel prices.
Type string · GET query or POST JSON · Default USD
Example / input hint: USD
ALLDZDARSAMDAWGAUDAZNBSDBHDBYNBMDBAMBRLGBPCADXPFCLPCNYCOPCRCCUPCZKDKKDOPEGPEURGELHKDHUFISKINRIDRIRRILSJMDJPYJODKZTKWDLBPMKDMYRMXNMDLMADTWDNZDNGNNOKOMRPKRPABPENPHPPLNQARRONRUBSARRSDSGDZARKRWSEKCHFTHBTRYUAHAEDUSDVNDlanguageLanguage for hotel 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. Google Hotels exposes only the first page, so page must be 1.
Type integer · GET query or POST JSON · Default 1
Example / input hint: 1
- Minimum: 1
- Maximum: 1
limitMaximum hotels to return.
Type integer · GET query or POST JSON · Default 25
Example / input hint: 25
- 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": {
"destination": "London",
"checkin": "2027-01-14",
"checkout": "2027-01-17",
"adults": 2,
"children": null,
"rooms": 1,
"currency": "USD",
"language": "en-us",
"page": 1,
"limit": 25
},
"accommodations": [
{
"property_id": "0x4876055d6b06985f:0x6e0ccf819d405481",
"name": "Lost Property St Paul's London - Curio Collection by Hilton",
"url": "https://www.google.com/travel/hotels?q=Lost%20Property%20St%20Paul's%20London%20-%20Curio%20Collection%20by%20Hilton",
"image_urls": [
"https://lh3.googleusercontent.com/grass-cs/AABkmLfrx__5Z-gKAO5L3qRoub19R5VQsY5T7x0FcH-IHFatt4KWReUoi2nSmVJV5SgkX384ogJt1MuVtP91hL48jj_791PiMl42edK3SyCgujuvBlIVKoe61fPTw92u9elmWyfOUr_04Q=s287-w287-h192-n-k-no-v1",
"https://lh3.googleusercontent.com/grass-proxy/AIM7gW37fSfVVZzgh2eqptfV9FFV70ZmF3f6N_97QB4w-TQAHcEkrWvQ83otCm1zRbiGSFMwPqqbJp3G7X9zQCDTBGnMaLCojpxPncOFbsIl3OY5r1IFflU_I4lCH5MmmR12Eq-e--U3Dx6prrDcBbbV5GPzjCXa_exs3maFtIArV5jKn53lcIL9gqjQ=s287-w287-h192-n-k-no-v1"
],
"location": null,
"latitude": 51.5137177,
"longitude": -0.1011041,
"rating": 4.6,
"review_count": 593,
"price": {
"nightly": 175.25,
"stay_total": 526,
"currency": "USD"
},
"availability": "available"
},
{
"property_id": "0x4876034824cbc437:0xcb55e6ff166d412c",
"name": "The Tower Hotel, by Thistle",
"url": "https://www.google.com/travel/hotels?q=The%20Tower%20Hotel,%20by%20Thistle",
"image_urls": [
"https://lh3.googleusercontent.com/grass-cs/AABkmLfdliOblmT26U_rR0W-zVPoZK7bLux9HgSQAQex_fVF-75WuF-C24m8zcWCoa5E3X-UGgPststL0RJAscjGpY8JojrFww2JBtb_sFryVEfj615rORtnQHYQggKgDbruPRXs-ylfFQ=s287-w287-h192-n-k-no-v1",
"https://lh3.googleusercontent.com/grass-cs/AABkmLctbhf_f7KUILjiUlMm-hAZilI4v9NZroYnrRFHNLC7D8-QKZSIKqFM3CW4StC6cJPL3DO2SEzD9s7u7g9yaXOcNeiQxcQ4BHIiEblmeInsTlkA4AIv6IXbHfjGBKi327lyMhS3yw=s287-w287-h192-n-k-no-v1"
],
"location": null,
"latitude": 51.506786,
"longitude": -0.0739649,
"rating": 4.1,
"review_count": 12610,
"price": {
"nightly": 103.67007,
"stay_total": 311,
"currency": "USD"
},
"availability": "available"
},
{
"property_id": "0x487604ce9589fd65:0x1a604a9db3e45192",
"name": "The Clermont London, Charing Cross",
"url": "https://www.google.com/travel/hotels?q=The%20Clermont%20London,%20Charing%20Cross",
"image_urls": [
"https://lh3.googleusercontent.com/grass-cs/AABkmLddB11JkXo0BE3iKvRGAcenEE_RvhEOnL_9OH30HRfdc4Ea39uf5T8DCamHPvYgBcuSll9AMVBIKMLdd_96WprLFP5dF3iVc4lrhN4ZZd2gzSbKXWybUq4Qg2pMdnSY_ysMAdkCCAtxV9Bg=s287-w287-h192-n-k-no-v1",
"https://lh3.googleusercontent.com/grass-cs/AABkmLdgyWCFw7Q8AvLZqJ8ls8QSL9TqFiThdHwbfxuchLsjv-UlJRaSYRdvgIm8HTEU-n8s9KnD_CubnopI1np7FSkvxon14VDcwua532dnF2HuP8PNWmXO_ABKqNCFHDMZlmqNMhE=s287-w287-h192-n-k-no-v1"
],
"location": null,
"latitude": 51.508409199999996,
"longitude": -0.12474299999999998,
"rating": 4.5,
"review_count": 3626,
"price": {
"nightly": 183.78996,
"stay_total": 551,
"currency": "USD"
},
"availability": "available"
}
],
"pagination": {
"page": 1,
"has_more": false,
"next_page": null,
"returned_count": 3
},
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}