HotelPlanet

Complete hotel booking and management system. Search hotels, check availability, make bookings, and manage reservations. Perfect for travel agencies, booking platforms, and hotel management workflows.
Join our community

Actions8

Overview

This node integrates with a hotel booking and management system, allowing users to search for hotels, check availability, make bookings, and manage reservations. The "Get Hotels by Location" operation specifically enables searching for hotels filtered by country, city, price range, rating, and amenities. This is useful for travel agencies, booking platforms, or any workflow that needs to find suitable hotels based on location and preferences.

Practical examples:

  • A travel agency workflow that fetches hotels in Paris within a certain price range and minimum rating.
  • A booking platform filtering hotels in the USA offering free Wi-Fi and breakfast.
  • An automated system that suggests hotels in a city based on user budget and desired amenities.

Properties

Name Meaning
Country Optional filter by country name to narrow down hotel search
City Optional filter by city name to narrow down hotel search
Min Price Minimum price filter (numeric) to exclude hotels below this price
Max Price Maximum price filter (numeric) to exclude hotels above this price
Rating Minimum rating filter (numeric) to include only hotels with at least this rating
Amenities Comma-separated list of amenities to filter hotels that offer these features

Output

The output is an array of JSON objects representing the API response from the hotel system. Each item contains the full data returned by the API under a json property. The structure depends on the external API but typically includes hotel details such as name, location, price, rating, amenities, and availability.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "success": true,
  "hotels": [
    {
      "id": "123",
      "name": "Hotel Example",
      "country": "France",
      "city": "Paris",
      "price": 150,
      "rating": 4.5,
      "amenities": ["WiFi", "Breakfast"]
    }
  ]
}

Dependencies

  • Requires an API key credential for authentication with the HotelPlanet API.
  • The base URL for the API is configurable via credentials; defaults to http://localhost:3000.
  • Uses the Axios HTTP client library internally to make REST API calls.

Troubleshooting

  • Common issues:
    • Missing or invalid API credentials will cause authentication failures.
    • Providing invalid filter values (e.g., negative prices) may result in no results or errors.
    • Network connectivity issues can prevent API calls from succeeding.
  • Error messages:
    • "API request failed" indicates the external API responded with an error or unexpected format.
    • Errors thrown by the node include descriptive messages from the API when available.
  • Resolutions:
    • Verify API credentials are correctly configured and valid.
    • Ensure input parameters conform to expected types and ranges.
    • Check network access to the API endpoint.

Links and References

Discussion