hotelscan.ai APIhotelscan.ai ↗
Access hotel details, room availability, guest reviews, flexible date pricing, and destination suggestions from hotelscan.com via 7 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/e9948ea1-eeaf-4018-8997-fd134e61ab9f/get_autocomplete_suggestions?query=Paris' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for destination or hotel suggestions by name. Returns matching cities, regions, and hotels with their IDs, which can be used as inputs for other endpoints.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query for destination or hotel name (e.g. 'Paris', 'Hilton New York'). |
{
"type": "object",
"fields": {
"items": "array of suggestion objects with id, name, type, additionalInfo, countryCode, imageUrl",
"hasResults": "boolean indicating whether any results were found"
},
"sample": {
"data": {
"items": [
{
"id": "139497",
"name": "Paris",
"type": "City",
"geoId": "TOR-5401",
"imageUrl": "https://res.cloudinary.com/lastminute-contenthub/image/upload/v1/DAM/Artwork/SEM Pages/Dynamic template hero/paris-spring.jpg",
"countryCode": "FR",
"additionalInfo": "France"
}
],
"hasResults": true
},
"status": "success"
}
}About the hotelscan.ai API
The Hotelscan API gives developers access to 7 endpoints covering hotel search, room availability, guest reviews, flexible date pricing, and destination discovery from hotelscan.com. Starting with get_autocomplete_suggestions, you can resolve a city or hotel name to structured IDs, then chain those IDs into endpoints for room configurations, cancellation policies, and multi-source review aggregates — all returning structured JSON.
Hotel Search and Static Details
get_autocomplete_suggestions accepts a free-text query (city name, region, or hotel name) and returns an array of suggestion objects, each with an id, name, type, countryCode, and imageUrl. The returned id values feed directly into every other endpoint. get_hotel_details uses a hotel_id and optional date_from/date_to to return both a static block — covering name, address, amenities, category, coordinates, images, hotelOpinion, descriptionMap, and serviceMap — and a pricing object when dates are supplied.
Room Availability and Pricing
get_hotel_rooms requires hotel_id, date_from, and date_to, and optionally a destination_id for accurate pricing. It returns a selectedHotel object containing a rooms array where each entry includes the room name, amenities, images, and configurations — the configurations hold per-booking pricing and cancellation policy details. The response also surfaces a currency code and a pricingId for the session. get_flexible_dates_prices covers a broader date window, returning a products array of daily price entries with date, price, and availability info, plus range-level minPrice and maxPrice.
Reviews and Similar Hotels
get_hotel_reviews returns a data object containing a reviews array (with reviewer names, ratings, and text), totalReviewsCount, displayedReviewsCount, and sources indicating which review providers contributed. Optional sort (supports date_desc), limit, and offset parameters allow basic pagination. get_similar_hotels returns comparable properties with fields including hotel_name, stars, rating, reviews_num, hotel_address, price, and internal_id_hotel — the last of which can be fed back into detail or review endpoints.
Destination Discovery
get_location_destinations requires no inputs and returns the cardData array from hotelscan.com's featured destinations feed. Each card carries a title, image, buttonLabel (which displays a price), and an anchor with link metadata. A feedName field and hasMoreData boolean round out the response.
- Build a hotel search widget that resolves typed city or property names to IDs using get_autocomplete_suggestions before fetching prices.
- Display a price calendar for flexible travelers by querying get_flexible_dates_prices across a 30-day window to show cheapest available nights.
- Aggregate guest sentiment by pulling multi-source reviews via get_hotel_reviews sorted by most recent date.
- Compare room types and cancellation policies side-by-side using the configurations array from get_hotel_rooms.
- Populate a 'similar hotels' recommendation panel with star ratings, guest scores, and starting prices from get_similar_hotels.
- Generate destination landing pages with featured cards, display prices, and imagery from get_location_destinations.
- Cache and display static hotel metadata (amenities, coordinates, images, descriptions) using get_hotel_details without requiring date inputs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.