DataForSEO Business Data APIInstall

Summary

Searches Google Hotels for hotels matching a keyword and location, with optional travel dates, guest details, and hotel filters. This queued task request is submitted to DataForSEO and polled for its result.

Inputs

• Keyword (required) — Search term, up to 700 characters; the field may also accept a CID, place ID, or SPP parameter.
• Location (required) — Full name of the search location.
• Language (required) — Full name of the language for the search.
• Location Coordinate — Optional latitude,longitude,radius to refine the search.
• Task Priority — Normal or high execution priority; defaults to normal.
• Depth — Number of results to retrieve, from 1 to 140; defaults to 20.
• Check-in Date — Check-in date; if omitted, DataForSEO uses tomorrow.
• Check-Out Date — Check-out date; if omitted, DataForSEO uses the date two days from now.
• Currency — Currency for hotel prices.
• Number of Adults — Guest count selection. The UI defaults to 1, though the hint says the API default is 2 if omitted; adults and children together are limited to 6 people.
• Number and Age of Children — Optional list of child ages from 0 to 17; omitted means no children.
• Hotel Stars — Optional star ratings to include.
• Minimum Rating — Optional minimum hotel rating.
• Results Sorting Parameters — Sort by relevance (default), lowest price, highest rating, or most reviewed.
• Minimum Price Per Night — Optional lower nightly price bound.
• Maximum Price Per Night — Optional upper nightly price bound.
• Hotels With a Free Cancellation? — Whether to filter for free cancellation; defaults to false.
• Search for Vacation Rentals — Whether to include vacation rentals; defaults to false.
• Hotel Amenities — Optional amenities filter, such as free WiFi, parking, pool, or restaurant.

Output shape

A single DataForSEO task response object per input item.

The node posts a task and polls its task-get endpoint until a response status other than 40601, 40602, or 20100 is returned. Errors are thrown unless Continue On Fail is enabled, in which case the original input item and error are returned.

Examples

Example 1: Find hotels in Paris for two nights

Use a hotel-related keyword, set Location to Paris and Language to English, and provide check-in/check-out dates. Optionally filter by price, rating, stars, or amenities.

Links

• n8n community nodes installation guide