API Reference
OpenAPI SpecHolidu WhitelabelsPartner PortalHolidu
Start typing to search…

Search for offers based on the provided criteria

post
https://external-api.holidu.com/search

Retrieve a paginated list of offers matching specified filtering criteria, ranked by relevance. If dates are provided, only available offers for those dates are returned with exact pricing. Each offer includes basic property information.

Body Params
integer
0 to 10000

Zero-based page index

integer
1 to 50

Number of results per page

string
locationBoundingBox
object

Bounding box of the search location. Overrides the searchTerm parameter

date

Check-in date in ISO format YYYY-MM-DD

date

Check-out date in ISO format YYYY-MM-DD

integer
required
1 to 50

Number of adult guests

integer
required
0 to 50

Number of child guests

childrenAges
array of integers
length between 1 and 50

Ages of child guests, defaults to 10 if not specified

childrenAges
integer
≥ 1

Number of bedrooms

string
required

Locale code in format ISO 639-1 + ISO 3166-1 alpha-2, e.g. "en-US"

string
required

Currency code in ISO 4217 format, e.g. "USD"

propertyTypes
array of strings

List of property types

propertyTypes
propertyIds
array of strings
length between 1 and 50

List of property IDs to search for specifically (max 50)

propertyIds
facilities
array of strings

List of facilities

facilities
extras
array of strings

Extra fields to include in the response. Supported values: description, photos, facilities

extras
string
length between 1 and 80

Only for special cases, consult Holidu

integer
1 to 99999

Only for special cases, consult Holidu

Responses

Updated 6 months ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 6 months ago