Skip to content

▪ Seasonal Peak Series

Seasonal Peak Series API returns a time-based index score series for the specified {Location}, grouped by a time period.

Request

Endpoint

GET/v4/ondemand/account/{account_id}/locations/index/seasonality/series
GET/v4/licence_id/{licence_id}/territorial/index/seasonality/series

Path Parameters

Name                       Description Type Examples
*{account_id} Provided identifier of the account. string
*{licence_id} Provided identifier of the licence. string

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                
*{Location} Location identifier. Geospatial Area
GeometryID
Circle
*from Start date of timeframe. date 2020-01-01
*to End date of timeframe. date 2020-12-31
*period Time unit of the series. string day
week
month
ⓝ network Filter by network. string Dictionary
ⓝ 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
ⓝ user_type Filter by reviewer type. string Dictionary
ⓝ user_country Filter by reviewer's country of origin in ISO 3166-1 alpha-2 standard format (in lower case). string it
de
ⓝ content_language Filter by contents language in ISO_639-1 standard format. string en
fr
Supported values for period
  • week
  • month
Example 
curl -X GET 'https://api.datappeal.io/v4/licence/{licence_id}/territorial/index/seasonality/series?geometry_id=379c730942e570d586a5520770c0a65d&from=2025-01-01&to=2025-02-28&period=month' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \

Response

Status

Status Description
200 Seasonal Peak Series data has been successfully returned.

Body

SeriesIndex

Field Description Type
series Index series data for the requested timeframe and period. array[LocationSeriesIndexElement]
LocationSeriesIndexElement
Field Description Type
*period Date representing a specific day, corresponding to the first day of the requested period.
day: the day itself.
week: first day of the corresponding week.
month: first day of the corresponding month.		 date
*value Index score of corresponding period. LocationIndexScore
LocationIndexScore
Field Description Type
score Index score value in the range [0,100]. decimal
Example 
{
    "series": [
        {
            "period": "2025-01-01",
            "value": {
                "score": 31.21
            }
        },
        {
            "period": "2025-02-01",
            "value": {
                "score": 25.75
            }
        }
    ]
}