Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

This node integrates with the Outscraper API to retrieve reviews for Airbnb accommodations. It allows users to input direct links or IDs of Airbnb listings and fetches review data according to specified parameters such as sorting order, result limits, and filtering by date. This node is useful for market researchers, property managers, or analysts who want to monitor guest feedback on Airbnb properties programmatically.

Practical examples include:

  • Collecting recent guest reviews for a portfolio of Airbnb rentals to analyze customer satisfaction trends.
  • Extracting highly rated or low-rated reviews to identify strengths and weaknesses of specific listings.
  • Automating review monitoring workflows by receiving asynchronous callbacks when data collection tasks complete.

Properties

Name Meaning
Query Direct links or IDs of any Airbnb accommodation (e.g., full URL or numeric ID) to specify target listings.
Limit Maximum number of review results to return (minimum 1).
Sort Sort order for reviews: Most Recent, Rating Descending, or Rating Ascending.
Cutoff Oldest timestamp value for items; overrides sort to newest first if set.
Async Request Whether to make an asynchronous request (true/false).
Webhook URL to which Outscraper will send a POST request once the task finishes (used with async requests).
Additional Fields Collection of optional fields:
- Fields Specific fields to return in the response, comma-separated.
- UI Whether to execute the request as a UI task (boolean).

Output

The node outputs JSON data containing the retrieved Airbnb reviews matching the query parameters. Each item typically includes details such as reviewer information, review text, rating, date, and other metadata depending on requested fields.

If the asynchronous mode is enabled, the output may initially contain task status information, and the actual review data will be sent later via the specified webhook URL.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active Outscraper API key credential configured in n8n.
  • The node sends HTTP requests to the Outscraper API endpoint defined by the user's credentials.
  • For asynchronous requests, a publicly accessible webhook URL must be provided to receive callback POST requests from Outscraper.

Troubleshooting

  • Common issues:

    • Invalid or missing Airbnb listing URLs/IDs in the Query property can cause empty or error responses.
    • Exceeding the allowed limit or unsupported field names in Additional Fields may lead to API errors.
    • If using asynchronous requests without a valid webhook URL, the user will not receive the results.
    • Network connectivity or API key misconfiguration can cause authentication or connection failures.
  • Error messages:

    • Authentication errors indicate invalid or missing API keys; verify credentials in n8n settings.
    • "Invalid query" or "No results found" suggests incorrect or malformed Airbnb listing identifiers.
    • Timeout or webhook delivery failures require checking the webhook URL accessibility and correctness.

Links and References

Discussion