Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

This node interacts with the Outscraper API to retrieve reviews for hotels listed on Booking.com. It allows users to specify a hotel by direct link or ID and fetches customer reviews with various filtering, sorting, and pagination options.

Common scenarios where this node is beneficial include:

  • Market research: Gathering customer feedback on competitor hotels.
  • Sentiment analysis: Collecting review data for natural language processing.
  • Customer experience monitoring: Tracking recent reviews to respond promptly.
  • Data enrichment: Adding review insights to CRM or analytics platforms.

Practical example:

  • A travel agency wants to monitor recent guest reviews of a specific hotel to adjust their offerings accordingly. They provide the hotel's Booking.com URL and set the limit to 100 reviews sorted by most recent descending.

Properties

Name Meaning
Query Direct links or IDs of any booking hotel (e.g., https://www.booking.com/hotel/tr/old-town-point-amp-spa-antalya.html or old-town-point-amp-spa-antalya). This identifies the hotel for which reviews are fetched.
Reviews Limit Maximum number of review results to return. Must be at least 1. Default is 50.
Skip Number of items to skip for pagination purposes. Default is 0.
Sort Sort order for reviews. Options:
• Default (no specific sort)
• Recent Ascending
• Recent Descending
• Score Ascending
• Score Descending
Cutoff Oldest timestamp value for items; overrides sort to newest first. Only reviews newer than this timestamp will be returned. Default is 0 (no cutoff).
Language Language code to use for the website interface (e.g., "en" for English). Default is "en".
Region Country code to use for the website (affects localized content). Default is empty (no specific region).
Async Request Boolean flag indicating whether to make an asynchronous request. If true, the task runs asynchronously. Default is false.
Webhook URL address to which Outscraper will send a POST request once the asynchronous task is finished. Used only if Async Request is true.
Additional Fields Collection of optional fields:
• UI (boolean): Whether to execute the request as a UI task.
• Fields (string): Specific fields to return, comma-separated list.

Output

The node outputs JSON data containing the retrieved reviews for the specified Booking.com hotel. The structure typically includes:

  • Review details such as reviewer name, rating score, review text, date, and other metadata depending on requested fields.
  • Pagination information based on the limit and skip parameters.
  • If asynchronous mode is used, the output may initially contain task status or identifiers, with actual review data delivered later via webhook.

No binary data output is expected from this node.

Dependencies

  • Requires an active Outscraper API key credential configured in n8n.
  • Internet access to call the Outscraper API endpoint.
  • Optional webhook URL must be publicly accessible if asynchronous requests are used.

Troubleshooting

  • Invalid Query: If the provided hotel link or ID is incorrect or malformed, the node may return errors or empty results. Verify the input format matches Booking.com URLs or valid IDs.
  • API Key Issues: Missing or invalid API key will cause authentication failures. Ensure the API key credential is correctly set up.
  • Rate Limits: Exceeding Outscraper API rate limits can result in throttling or errors. Consider reducing request frequency or batch sizes.
  • Async Mode Misconfiguration: When using async requests, ensure the webhook URL is reachable and correctly handles POST callbacks.
  • Empty Results: If no reviews are returned, check filters like cutoff date, language, or region that might exclude all data.

Links and References

Discussion