Skip to content


Rates Overall API returns rates overall data for the specified {Location}.



GET /v4/{billing_plan}/account/{account_id}/locations/rates/overall/

Path Parameters

Name                       Description Type Examples
*{billing_plan} Billing plan to be applied to the call. string ondemand
*{account_id} Provided identifier of the account. string
/sample Filter data for POIs that are included in the sample (subset of POIs that statistically replicates the population of the corresponding location). string
/sample optional path parameter

Inserting optional path parameter /sample in the following position:

  • /v4/{billing_plan}/account/{account_id}/locations/sample/…

will filter data for POIs that are included in the sample (subset of POIs that statistically replicates the population of the corresponding location).

Header Parameters

Name                          Description Type Examples                         
*x-api-key Provided API key {x_api_key} that allows authentication. string
*Authorization Provided token {jwt_bearer} that allows authorization. string Bearer {jwt_bearer}

Query Parameters

Name                       Description Type Examples                 Default
*{Location} Location identifier. Geospatial Area
*from Start date of timeframe. date 2020-01-01
*to End date of timeframe. date 2020-12-31
percentile Request percentile expressed in the range (0, 1).
Median value 0.5 will always be implicitly requested.
decimal 0.5
poi_class Filter POIs with "category": "hotel" by stars rating in the range [1,5]. int 4
poi_industry Filter by POI Industry. string Dictionary
poi_category Filter by POI Category. string Dictionary
facility Filter offers by included facility. string breakfast
guests Filter offers by number of allowed guests. int 1 2
refundable Filter offers that can be refunded. boolean true
scan_last_day Filter data according to a less recent offers detection in the range [1,10] (from most recent to oldest offers detection day). int 5 1
Supported values for facility
  • breakfast
  • lunch
  • dinner
curl -X GET '{account_id}/locations/rates/overall?geometry_id=379c730942e570d586a5520770c0a65d&from=2021-01-01&to=2021-07-01' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \
Example /sample
curl -X GET '{account_id}/locations/rates/sample/overall?geometry_id=379c730942e570d586a5520770c0a65d&from=2021-01-01&to=2021-07-01' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \



Status Description
200 Rates Overall data has been successfully returned.



Field Description Type Examples
*poi Count of POIs with accommodation offers within the group. PartitionCount
average Average accommodation offers price in Euros. decimal 88.44
*percentiles Accommodation offers percentiles values expressed in Euros. array[Percentile]
Field Description Type
partition Count incidence percentage of the group's elements over total elements. int
count Total elements of the group. int
Field Description Type Examples
*request Requested percentile expressed in the range (0, 1), e.g. 0.5 (the median). decimal 0.5
*response Resulting value of the request percentile. decimal 73.00
Value of $.poi.partition

For non-grouped API calls, this value will always be 100.0: since no grouping is taking place, the total is considered as one whole group.

    "poi": {
        "partition": 100.0,
        "count": 2370
    "average": 179.64,
    "percentiles": [
            "request": 0.5,
            "response": 111.5522