Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

The Booking Search operation in this node allows users to perform searches on Booking.com using custom search parameters embedded in a query string. This is useful for retrieving accommodation listings or other booking-related data filtered by specific criteria such as location, dates, or amenities.

Typical use cases include:

  • Automating the retrieval of hotel or lodging options for a given city or region.
  • Extracting booking data for market analysis or price comparison.
  • Integrating Booking.com search results into workflows that require accommodation information.

For example, a user can input a search URL query like ss=Rome%2C+Lazio%2C+Italy to get listings for Rome, Italy, and limit the number of results returned.

Properties

Name Meaning
Query The search parameters as a query string (e.g., ss=Rome%2C+Lazio%2C+Italy) used to filter Booking.com results. Required.
Limit Maximum number of results to return. Must be at least 1. Default is 50.
Async Request Whether to make the request asynchronously. If true, the node will initiate the search and return immediately, expecting a webhook callback later.
Webhook A URL to which Outscraper will send a POST request once the asynchronous task is finished. Used only if Async Request is enabled.
Additional Fields Collection of optional fields:
• UI: Boolean indicating whether to execute the request as a UI task.
• Fields: Comma-separated list of specific fields to return in the response.

Output

The node outputs JSON data containing the search results from Booking.com based on the provided query parameters. The structure typically includes an array of listings or search results with details such as accommodation names, locations, prices, ratings, and other relevant booking information.

If the Async Request option is enabled, the output may initially contain task status information, and the final results will be delivered via the specified webhook URL.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for Outscraper service authentication.
  • Needs the base URL of the Outscraper API configured in the node credentials.
  • For asynchronous requests, a publicly accessible webhook URL must be provided to receive callbacks.

Troubleshooting

  • Empty or no results: Ensure the query string is correctly formatted and valid for Booking.com search parameters.
  • API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Webhook not receiving data: Confirm that the webhook URL is publicly accessible and correctly configured to accept POST requests.
  • Limit value issues: The limit must be a positive integer; values less than 1 may cause errors.
  • Async flag misuse: Setting async to true without providing a webhook URL will result in incomplete processing.

Links and References

Discussion