Booking Discover Review Season Filters API

Request documented time-of-year segments metadata for hotel_id with optional language_code and currency_code. Inspect supported identifiers before passing them to filter_time_of_year in get-hotel-review. This dedicated metadata response was not live-validated; option labels, counts, and completeness must be checked in actual data. It retrieves filter choices, not the corresponding review pages.

API Features

Hotel review seasonal choices Inspect available time-of-year filters for the selected property.

Season-token provenance Reuse the returned identifiers instead of inventing month-range strings.

Seasonal review-query planning Choose supported seasonal segments before collecting review pages.

Season metadata not stay availability Keep these feedback filters separate from hotel availability calendars.

Live API Demo

GET /api/project/booking/get-hotel-review-filter-time-of-year

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/booking/get-hotel-review-filter-time-of-year?key=<API_KEY>&hotel_id=180769'

curl -X GET 'https://api.opendata-api.com/api/project/booking/get-hotel-review-filter-time-of-year?key=<API_KEY>&hotel_id=180769'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Populate a review season selector from supported hotel-specific choices.
Plan a bounded seasonal traveler-feedback comparison.
Validate a saved time-of-year token before reusing an audit request.
Check whether seasonal filtering is available across a research hotel sample.

Frequently asked questions

Can I use arbitrary month ranges for seasonal reviews?

Use supported returned identifiers. Documentation illustrates values such as 03_06 and 06_09, but it does not authorize arbitrary invented tokens, and this route was not live-validated.

Does this request retrieve the reviews matching time-of-year segments?

No. It is the documented filter-discovery step. After validating the returned choices, pass supported values to filter_time_of_year in get-hotel-review to request review pages.

Related operations

Guides

View Subscription Plans →