Get hotel catalog files
Returns download links for the current hotel catalog files.
Returns download links for the current hotel catalog files.
Returns { generatedAt, hotelCount, files: [{ variant, url, sizeBytes }] }, one zip per variant. Each
zip holds hotels.jsonl: one hotel per line, in the item shape that search and
properties/{id} return, with offers empty. withoutImages carries each hotel's main
image as logoUrl and an empty details.imageUrls; withImages also lists every gallery
image there. generatedAt is null and files empty before the first catalog is built, and after
a release that changes the line format until the first build in the new format: the route never links a
file whose lines have another format. The route takes no query parameters.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
OK
- response
generatedAt?|When the current files were built (UTC); null before the first build, and after a release that changes the line format until the first build in the new format.
date-timehotelCount*integerHotels in each file; 0 when there are no files.
int32files*array<>The current catalog zips, one per variant; empty whenever generatedAt is null.
replacements?|The complete confirmed ID replacement map for this build; null before its first build.
curl -X GET 'https://api.sandbox.openroam.com/v1/hotels/catalog/files'{ "generatedAt": "2019-08-24T14:15:22Z", "hotelCount": 0, "files": [ { "variant": "withoutImages", "url": "string", "sizeBytes": 0 } ], "replacements": { "url": "string", "sizeBytes": 0, "count": 0 }}List hotel amenities GET
Returns the amenity catalog: every amenity code and group with its display label. Use it to label the `amenityGroups` codes in hotel content and to build an amenity filter; send codes back in search `filters.amenityCodes`. `notesLabel` is the heading for a hotel's uncoded `amenityNotes`. Labels follow the request language, as `Accept-Language` sets it; the route takes no query parameters.
Search hotel destinations GET
Finds the places to search hotels in by name: a country, a region, a city or a district. Returns `{ items }`: at most `limit` places whose names match `q`, most relevant first, without paging. Send a place's `id` as `searchCriteria.location.geoNodeId` in a search; it finds the hotels of every place inside it. `name` includes the place's parents, for example "Downtown Dubai, Dubai, United Arab Emirates", and `category` is its level: `country`, `region`, `city` or `area`. Only places where OpenRoam has had hotels are listed. `q` is required: plain text, at most 100 characters, without control characters. `countryCode` keeps the places of one ISO 3166-1 alpha-2 country; `limit` is 1–100 (default 10). An invalid or blank value, or any other query parameter, gives 400 / 10001. 503 / 10007 when the destination index is unavailable or does not answer within 5 seconds: retry.