Airbnb Place ID Autocomplete API - Destination Suggestions

Enter a partial destination in query, optionally languageCode and limit from 1 to 5. The live Paris lookup returned status:true, message:Successful and a data array of suggestions. Each suggestion included display_name, explore_search_params.place_id and location with countryCode and bounding_box coordinates. The selected Paris place_id was reused successfully in both stay and experience searches. Preserve that value exactly; it is not interchangeable with the separate location.google_place_id. Destination suggestions are a read-only starting point and do not reserve accommodation or activities.

API Features

Reusable explore place identifier Observed explore_search_params.place_id values worked unchanged in downstream stay and experience searches.

Named destination suggestions Read display_name to distinguish a city from landmarks and nearby administrative areas.

Destination bounds and country Use location.bounding_box and countryCode to initialize a destination map and geographic context.

Small suggestion batches Set limit between 1 and 5; the observed Paris request returned three suggestions with limit=3.

Live API Demo

GET /api/project/airbnb-search/common-auto-complete

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/common-auto-complete?key=<API_KEY>&query=Paris&languageCode=en-US&limit=3'

curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/common-auto-complete?key=<API_KEY>&query=Paris&languageCode=en-US&limit=3'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Add a destination picker that stores the selected display name together with its reusable place identifier.
Initialize a destination map from the chosen suggestion's bounding box before searching stays.
Disambiguate a city, landmark and district that share a partial destination name.
Share one selected destination between accommodation and local-experience discovery forms.

Frequently asked questions

Which identifier should I pass to stays-search or experiences-search?

Copy explore_search_params.place_id from the chosen suggestion. Do not substitute location.google_place_id, a suggestion id or the display label; the live workflow reused the returned place_id without modifying it.

What is a safe first destination lookup?

The observed request used query=Paris, languageCode=en-US and limit=3. It returned Paris, France and related locations. You can change the destination text; running the lookup only reads suggestions and creates no booking.

Related operations

Guides

View Subscription Plans →

Find Destinations and Reusable Place IDs