API Reference
Use Crawlora's Hotels.com API endpoints to extract supported public Hotels.com data as structured JSON. This documentation covers 7 active endpoints including Get Hotels.com destination suggestions, Get Hotels.com room offers, Get Hotels.com property details, Get Hotels.com rates for one property, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as q, request, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/hotels/autocomplete?q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/hotels/autocompleteapiKey1 credit/requestReturns anonymous Hotels.com search-box suggestions for a partial destination or property name. Availability and prices are not included.
Required params: q:query
/hotels/offersapiKey4 credits/requestReturns the public room/unit offer summaries shown for one Hotels.com property and date range, including room labels and non-transactional offer messages. Booking, checkout, payment, and reservation tokens are never returned. property_id is the numeric global property id from a Search response.
Required params: request:body
/hotels/propertyapiKey3 credits/requestReturns public static metadata from one canonical Hotels.com property page, including name, address, rating, images, and amenities. Date-bound availability, prices, booking, and review content are excluded.
Required params: request:body
/hotels/ratesapiKey3 credits/requestReturns one Hotels.com property's date-bound rates and availability: the same normalized property card Search returns, with the live per-night and per-stay prices Hotels.com shows for the requested dates. property_id is the numeric global property id from a Search response's properties[].id; it is distinct from the legacy /ho<id>/ URL id.
Required params: request:body
/hotels/reviewsapiKey3 credits/requestReturns one Hotels.com property's review overview: the overall rating (0-10) with its descriptive label, the per-category sub-ratings (cleanliness, service, amenities, and so on), and a bounded set of highlighted guest reviews with reviewer, date, rating label, text, and verified-stay flag. property_id is the numeric global property id from a Search response's properties[].id. This mirrors the property page's Guest reviews section; the full paginated review archive is not exposed.
Required params: request:body
/hotels/reviews/archiveapiKey4 credits/requestReturns one page of public guest reviews for a Hotels.com property, including reviewer, date, traveler type, rating label, title, and message. Use page and page_size to walk the archive; the response reports whether another page is available. property_id is the numeric global property id from a Search response's properties[].id. Booking, account, and private review data are not included.
Required params: request:body
/hotels/searchapiKey5 credits/requestReturns a page of date-bound Hotels.com hotel search results for either a free-text destination or a numeric Hotels.com region_id: normalized property cards with per-night and per-stay prices, review score and count, location, thumbnail, amenities, and promotional badges. Provide exactly one of query or region_id; region_id skips destination typeahead resolution. Prices are the live rates Hotels.com shows for the requested check-in and check-out dates.
Required params: request:body
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Hotels.com destination suggestions | /hotels/autocomplete | GET | 1 credit/request | q:query | View docs | Try endpoint |
| Get Hotels.com room offers | /hotels/offers | POST | 4 credits/request | request:body | View docs | Try endpoint |
| Get Hotels.com property details | /hotels/property | POST | 3 credits/request | request:body | View docs | Try endpoint |
| Get Hotels.com rates for one property | /hotels/rates | POST | 3 credits/request | request:body | View docs | Try endpoint |
| Get Hotels.com guest reviews | /hotels/reviews | POST | 3 credits/request | request:body | View docs | Try endpoint |
| List Hotels.com guest reviews | /hotels/reviews/archive | POST | 4 credits/request | request:body | View docs | Try endpoint |
| Search Hotels.com hotels | /hotels/search | POST | 5 credits/request | request:body | View docs | Try endpoint |