The Airbnb Search action is used to search and list Airbnb data within your application. It allows users to query suitable accommodation options based on a specific location, date range, and various filters. It is particularly preferred in travel, tourism, or reservation-based applications.

Technical Features

Search Process (Search Panel): The Airbnb Search action retrieves relevant results from Airbnb based on specified parameters. Users can enter fixed values or connect dynamic values (Action Result, Current, Form Component, Screen Input, etc.) via the Symbol Picker.

Parameter Compatibility:

• location (String – required): The name of the city or region to search.
• placeId (String – optional): Airbnb's system-specific location ID. Can be used for more accurate results.
• pageCursor (String – optional): Used for pagination; loads the next set of results.

Optional Parameters:

• checkIn, checkOut: Stay dates.
• numberOfAdults, numberOfChildren, numberOfInfants, numberOfPets: Guest information.
• minPrice, maxPrice: Price filters.

Web & Mobile Support: The Airbnb Search action works seamlessly on both web and mobile applications.

Airbnb Search Action Application Steps

1. Defining the Action in UI Design

• Open your project on the Kuika platform.

• Go to the UI Design module and select the screen where you want to perform the Airbnb search.
• Add a button (e.g., “Search Homes” or “Airbnb Search”).
• Select the button and add the OnClick → Airbnb → Airbnb Search action from the + ADD ACTION menu.

2. Configuring Parameters

• location (required): You can link the city information entered by the user with Text Input.
• checkIn, checkOut: Can be retrieved from date picker elements.
• numberOfAdults, numberOfChildren: Can be linked to form inputs.
• minPrice, maxPrice: Can be set using a Slider or Number Input.
• pageCursor: Can be used for infinite scroll scenarios.

All these values can be linked via the Symbol Picker.

Use Case: Searching for Airbnb Homes in Istanbul

In a travel app, the user selects check-in and check-out dates for Istanbul, specifies the number of people, and clicks the “Search Homes” button.

Steps:

1. Add a form in UI Design:
   
   • Location (TextInput → “Istanbul”)
   • Check-In (Date Picker)
   • Check-Out (Date Picker)
   • Number of Guests (Number Input)
2. Add a “Search for Homes” button.
3. OnClick → Add the Airbnb → Airbnb Search action.
4. Connect the parameters to the forms via the Symbol Picker.
5. Display the returned results in a Table element.

Airbnb Search Advanced Customizations

• Dynamic Filtering: New results can be automatically retrieved when the user changes the price range.
• Conditional Display: If no results are found, you can display the message “No suitable homes found.”
• Transferring Results to Other Actions: The Airbnb Search result can be used on another page with a Set Value action.
• Pagination: You can load the next results with the “Show More” button using pageCursor.

Technical Risks and Controls

• Location must not be empty. Since the parameter is required, the action will return an error otherwise.
• checkIn and checkOut formats must be correct (YYYY-MM-DD).
• Guest counts must not be negative or zero.
• pageCursor should only be used with values returned from the API.