In the next sections we will show different search options and examples when using different filters.
The following JSON message represents a Search Request message example where the results are filtered by destination code, meaning that only results for that particular destination will be returned:
{
"filters": [{
"searchFilterItems": [{"type": "destination", "value": "BCN"}]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The exampled search will return all activities available between 29 March 2022 and 31 March 2022 in Barcelona Destination.
The exact meaning of each attribute can be found here. A list of available destinations can be retrieved by the calls included in the Contents API (destinations)
The following JSON message represents a Search Request message example where the results are filtered by Hotelbeds hotel code:
{
"filters": [{
"searchFilterItems": [{"type": "hotel", "value": "1524"}]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The exampled search will return all the activities between 29 March 2022 and 31 March 2022. If the activity is a ticket, it will return all the tickets in the same destination as the one linked to the hotel code 1524.
The following JSON message represents a Search Request message example where the results are filtered by a particular GPS coordinates or geolocation:
{
"filters": [{
"searchFilterItems": {"type": "gps",
"latitude": 41.49004,
"longitude":2.08161}]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The exampled search will return all the activities between 29 March 2022 and 31 March 2022. There will be a particularity in regards to whether the activity is a ticket or an excursion.
A Contents Factsheet is the set of attributes that provide all relevant information that describe an Activity. A content factsheet could define the contents for one or more than one service.
Request example is provided below:
{
"filters": [{
"searchFilterItems": {"type": "factsheet", "value": "15877"}]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The search call will provide only those services included in the content factsheet id 15877 and considering that dates are between 29 March 2022 and 31 March 2022.
Segmentation is composed by a group of attributes that categorize the activity. A segment or group of segments are included as attributes in the content factsheet. In regard to the use of segmentation it is important to understand that it CAN NOT be used by itself. It is mandatory to provide one of the following additional filters:
The reason for it is that if only segmentation is provided the number of resutls could be too high as it will provide product from all around the world that match that segmentation. An example is shown below where it is included the Destination and the Segmentation code being searched for:
An example of the JSON message is detailed below:
{
"filters": [{
"searchFilterItems": [
{"type": "segment", "value": "404"},
{"type": "destination", "value": "BCN"}
]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The example is looking for all products/services whose content factsheet contains the segment 88559 and that dates are between 29 March 2022 and 31 March 2022.
Segments available can be retrieved by the calls included in the Contents API (segments).
The Search API call has also the ability to filter results by a range of prices. The following is an example applying price from and to for a given destination:
{
"filters": [{
"searchFilterItems": [
{"type": "destination", "value": "BCN"},
{"type": "priceFrom", "value": "10"},
{"type": "priceTo", "value": "50"}
]
}],
"from": "2022-03-29",
"to": "2022-03-31"
}The example above uses a combined filter. The product that will be provided in the Search response will be only the product from Barcelona (BCN) destination where the price is between 10 and 50. The currency of the price is the same as the one configured for the client. The priceRange has to have always either a Destination Code or a GPS coordinate or a hotel code.
The Search API call has also the ability to filter results using keywords. When using the keywords and as detailed before it can only be done if the keyword is accompanied by either a DestinationCode, a HotelCode, or a GPS coordinates. The following is an example:
{
"language": "en",
"pagination": {
"itemsPerPage": 30,
"page": 1
},
"filters": [
{
"searchFilterItems": [
{"type": "gps", "longitude": "2.6416219","latitude": "39.6392898"},
{"type": "text","value": "beach"}
]
}
],
"to": "2022-05-15",
"order": "DEFAULT",
"from": "2022-05-08"
}The example above uses a combined filter. The product that will be provided in the Search response will be only the product based on the GeoCoordinates (longitude and latitude) as well as considering the filter of keywords ("text").
As explained above, the filters can be combined to generate “AND” and “OR” conditions. A few considerations have to be present before we implement combinations. These considerations are:
Now that we understand the considerations let's see one example of each.
{
"filters": [
{
"searchFilterItems": [
{"type": "destination", "value": "MCO"},
{"type": "text", "value": "night"},
{"type": "text", "value": "day"}
]
}
],
"from": "2022-07-29",
"to": "2022-07-29",
"language": "en",
"pagination": {
"itemsPerPage": 10,
"page": 1 },
"order": "DEFAULT"
}In this example the keywords "night" and "day" are linked with an AND.
However, if we wanted to do "night" OR "day" it shall be done using the following example:
{
"filters": [
{
"searchFilterItems": [
{"type": "destination", "value": "MCO"},
{"type": "text", "value": "night"}
]
},
{
"searchFilterItems": [
{"type": "destination", "value": "MCO"},
{"type": "text", "value": "day"}
]
}
],
"from": "2022-07-29",
"to": "2022-07-29",
"language": "en",
"pagination": {
"itemsPerPage": 10,
"page": 1 },
"order": "DEFAULT"
}The difference here is that you create two searchFilterItems in order to create the OR conditional.
IMPORTANT: you have to duplicate the destination line, as what you are actyually looking to do is: (Destination MCO and "night) OR (Destination MCO and "day").