Quicksearch
Quick search allows you to provide a short string (keywords) and API will return a list of known properties, locations or regions that match given string.
Quick search will only return results from Tour Operators that are connected to you API licence.
API Endpoints
It's API endpoint is, /search/<content type>/quicksearch[?query=query]
For example:
- For hotel:
/search/hotel/quicksearch - For pauschal:
/search/pauschal/quicksearch - For trips:
/search/trips/quicksearch
You can mix or match different content types for this query. For example,
URL /search/hotel,pauchal/quicksearch is a valid search endpoint, that
will do quicks earch for only hotel and pauschal types.
You can use special endpoint any that will execute search for any content
type.
Search parameters
Search parameters are different than base search. The required paramater
is only Query.
| Paramater | Format | Description |
|---|---|---|
| Query | string | Search query |
Search examples
Example 1
{
"Query": "teneri",
}
We're looking for anything that matches keyword teneri. Quick search results will contain only results that:
-
For regions and locations: Any region or location that matches in name teneri.
-
For products: Any product that matches in name teneri.
Example 2
{
"Query": "Aminess Azur",
}
This is an example of using multiple keywords. Query will return all products that have both keywords in their name.
Example 3
{
"Query": "Poreč Delfin",
}
In this example we search by location name and product name.
You can also cobine search string with region name for instance. Keyword order is not important.
{
"Query": "Poreč istra Delfin",
}
Filters and sorts
This query does not support filtering or sorting.
Response structure
Warning
Products field is limited to maximum of 300 entries.
typedef Results = struct{
# Contains list of results. If given category has not matched anything,
# the structure is ommited from search results.
Results struct{
# Found regions that match given query
Regions array{struct{
# Region name that matched given query
RegionName string
# Region ID that matched given query
RegionID int
# Region group this object belongs to
RegionGroupID int
RegionGroupName string
}}
Locations array{struct{
# Location name that matched given query
LocationName string
# Location ID that matched given query
LocationID int
# Region group and region (with coressponding IDs) this
# object belongs to
RegionGroupID int
RegionGroupName string
RegionID int
RegionName string
}}
# Matched products
Products array{struct{
# Contains product name that mached given query
ProductName string
# Contains the product ID that mached given query. This
# is an equivalent to an GIATA ID
ProductID int
# Product content type
Type string
Picture struct{
# URL to object thumbnail picture (about 100x66 px)
Thumbnail string
# URL to object full-scale picture
Full string
}
# Object category (1-5)
Category int
# Rating of the offer (0-100)
OfferRating int
# Percentage of guests recommending this object (0-100)
RecommendationPercentage int
# TourOperators that supplies this product
TourOperators array{string}
Location struct{
# Location name and its corresponding ID of this object
LocationName string
LocationID int
# Region group and region (with coressponding IDs) this
# object belongs to
RegionGroupID int
RegionGroupName string
RegionID int
RegionName string
# Object exact latitude and longitude. This information
# is missing for some objects
Latitude float
Longitude float
}
Facts map{
# Facts are short factoids about object properties.
# Key in this map is a fact short code, and it's value
# is a human-readable description of a factoid.
string => string
}
}}
}
}
Example response
{
"RequestID": "d17c4dcc-5fd33041eee08912222179",
"Results": {
"Products": [
{
"ProductName": "Hotel Komodor",
"ProductID": 15472,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/15472\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/15472\/320\/s"
},
"Category": 3,
"OfferRating": 78,
"RecommendationPercentage": 98,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.653198242188,
"Longitude": 18.063899993896
},
"TourOperators": [
"PALM",
"PALH",
"RIVA"
],
"Facts": {
"air": "klima",
"park": "parkiranje",
"bea": "direktno na pla\u017ei",
"spt": "bogat sportski program",
"pol": "vanjski bazen",
"stn": "tenis",
"sdv": "ronjenje",
"wifi": "wifi"
},
"Type": "hotel"
},
{
"ProductName": "Uvala",
"ProductID": 57714,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/57714\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/57714\/320\/s"
},
"Category": 4,
"OfferRating": 75,
"RecommendationPercentage": 70,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.652743,
"Longitude": 18.068702
},
"TourOperators": [
"PALM",
"PALH",
"RIVA"
],
"Facts": {
"bea": "direktno na pla\u017ei",
"pol": "vanjski bazen",
"stn": "tenis",
"wel": "bogata wellness ponuda",
"wms": "masa\u017ea",
"wbf": "beauty farm",
"wifi": "wifi",
"air": "klima",
"ipl": "unutranji bazen",
"park": "parkiranje",
"sdv": "ronjenje",
"spt": "bogat sportski program"
},
"Type": "hotel"
},
{
"ProductName": "Hotel Grand Hotel Park",
"ProductID": 13502,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/13502\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/13502\/320\/s"
},
"Category": 4,
"OfferRating": 53,
"RecommendationPercentage": 38,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.655398,
"Longitude": 18.073239
},
"TourOperators": [
"PALM",
"PALH"
],
"Facts": {
"wms": "masa\u017ea",
"wifi": "wifi",
"park": "parkiranje",
"ben": "v blizini pla\u017ee (cca. 100-500m)",
"spt": "bogat sportski program",
"ipl": "unutranji bazen",
"sth": "ostale sportske aktivnosti",
"wsn": "steam bath (turska kopel)",
"stn": "tenis",
"air": "klima",
"pol": "vanjski bazen"
},
"Type": "hotel"
},
{
"ProductName": "Valamar Lacroma Dubrovnik Hotel",
"ProductID": 134476,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/134476\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/134476\/320\/s"
},
"Category": 4,
"OfferRating": 92,
"RecommendationPercentage": 99,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.6600618,
"Longitude": 18.0633941
},
"TourOperators": [
"PALM",
"PALH",
"EUTO"
],
"Facts": {
"ben": "v blizini pla\u017ee (cca. 100-500m)",
"pol": "vanjski bazen",
"wsn": "steam bath (turska kopel)",
"sth": "ostale sportske aktivnosti",
"wifi": "wifi",
"sdv": "ronjenje",
"wms": "masa\u017ea",
"clb": "klub hotel",
"spt": "bogat sportski program",
"air": "klima",
"sws": "vodni sportovi",
"ipl": "unutranji bazen",
"park": "parkiranje",
"sbs": "sportovi sa loptom"
},
"Type": "hotel"
},
{
"ProductName": "Hotel Splendid",
"ProductID": 22023,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/22023\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/22023\/320\/s"
},
"Category": 3,
"OfferRating": 78,
"RecommendationPercentage": 74,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.653468,
"Longitude": 18.065602
},
"TourOperators": [
"PALM",
"PALH",
"RIVA"
],
"Facts": {
"wifi": "wifi",
"air": "klima",
"park": "parkiranje",
"bea": "direktno na pla\u017ei",
"spt": "bogat sportski program",
"stn": "tenis",
"sdv": "ronjenje"
},
"Type": "hotel"
},
{
"ProductName": "Hotel Vis",
"ProductID": 1696,
"Picture": {
"Thumbnail": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/1696\/74\/s",
"Full": "https:\/\/athena.ors.si\/api\/crs\/giata-pic\/1696\/320\/s"
},
"Category": 3,
"OfferRating": 58,
"RecommendationPercentage": 56,
"Location": {
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija",
"Latitude": 42.653155871141,
"Longitude": 18.067772984505
},
"TourOperators": [
"PALM",
"PALH",
"RIVA"
],
"Facts": {
"spt": "bogat sportski program",
"stn": "tenis",
"sdv": "ronjenje",
"wifi": "wifi",
"air": "klima",
"park": "parkiranje",
"bea": "direktno na pla\u017ei",
"ben": "v blizini pla\u017ee (cca. 100-500m)"
},
"Type": "hotel"
}
],
"Locations": [
{
"LocationName": "Dubrovnik",
"LocationID": 442,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska",
"RegionID": 100470,
"RegionName": "Ju\u017ena Dalmacija"
}
],
"Regions": [
{
"RegionName": "Ju\u017ena Dalmacija",
"RegionID": 100470,
"RegionGroupID": 100023,
"RegionGroupName": "Hrvatska"
}
]
}
}