Get hotel filter metadata for a destination and stay

View all Tripadvisor Hotel, Rental & Travel Data endpoints →

Request hotel-search filter metadata using a required geoId plus checkIn and checkOut dates in YYYY-MM-DD format. Use the geoId returned by the hotel location-search operation and keep it as the required string input here. No probe observation was supplied for this operation. The truncated documentation example shows a data object containing datePicker and a filters array; these are documentation-only fields, not verified probe results. The example datePicker contains configuration fields maxAdultsPerRoom, maxChildrenPerRoom, maxRooms and maxStayLength, as well as lastSelectableDate and timeZoneOffset. Example filter entries include name and title, nested filters, and, on some entries, minValue, maxValue, selectedRangeStart and selectedRangeEnd. Inspect the actual returned structures before exposing controls or mapping values into hotel-search parameters. Do not hard-code a universal list of facets, numeric limits, selectable dates or value encodings from the example. Refresh or invalidate cached choices when the destination or either stay date changes. This endpoint describes search controls; it does not return the hotel result list or confirm that a room can be booked.

API Features

Destination-specific facet discovery Use a location-search geoId and two stay dates to request the filter metadata for that search context. No successful probe is supplied for this operation.
Documented date-picker settings The unverified example includes datePicker.configuration limits plus lastSelectableDate and timeZoneOffset, allowing a date-picker integration to be designed around inspected fields rather than fixed assumptions.
Nested filter group inspection The documentation example contains data.filters entries with names, titles and nested filters. Inspect returned values before connecting any group to a hotel-search control.
Context-keyed filter caching Key any filter cache by geoId, checkIn and checkOut. Discard stale selected facets when that context changes instead of reusing controls from another stay.

Live API Demo

GET /api/project/tripadvisor-data/get-hotels-filter

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotels-filter?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&geoId=<geoId>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What inputs are required to retrieve hotel filter metadata?

geoId, checkIn and checkOut are all required strings. Obtain geoId through hotel location search and supply both dates in YYYY-MM-DD format. This operation does not declare adult, room or currency parameters.

Has the filter response been verified by a saved probe?

No probe observation was supplied for this operation. Its response-field descriptions come from a truncated documentation example and should be checked against an actual response before integration.

Which response fields are shown in the documentation example?

The example shows data.datePicker and data.filters. datePicker includes configuration, lastSelectableDate and timeZoneOffset. Filter entries include name, title, nested filters and, on some entries, range-related fields. This is not a verified complete response schema.

Can I reuse the same filter choices for every destination and date range?

Do not assume that. Keep the metadata associated with its geoId, checkIn and checkOut values, and invalidate selected facets when any of those values changes. Only expose options whose returned values and hotel-search mappings you have inspected.

Does this operation return hotel listings or guarantee availability?

No hotel result list is documented here. This operation is for search-control metadata; use hotel search for listings. Neither filter metadata nor an example date-picker limit guarantees bookable inventory.

Related operations

Guides

View Subscription Plans →