Overview
Beta Feature - Generate short, AI-written "Smart Highlight" cards for a hotel. Each highlight is a title plus a one or two sentence description, generated directly in the requested language.
Rate Limiting: This endpoint is rate-limited to 10 requests per minute per API key for both sandbox and production API keys. Exceeding this limit will result in a 429 Too Many Requests response.
When to Use
- Hotel detail pages - Show a few compelling reasons to consider a property
- Partner-specific tone - Adjust voice and emphasis per surface via
tone,styleand per-highlightcontext
What You Get
- Exactly
counthighlights, always, in the requested order typeechoed back from the request so you can map each card to your own UIgeneratedindicating whether the copy is AI-generated or template fallback
Behaviour
Hotel facts (name, city, country, description) are resolved server-side from hotelId; the caller never supplies them. Generated copy is grounded in those facts.
If AI generation fails, the endpoint still returns 200 with the requested number of neutral template highlights and generated: false. It never returns an empty array for a valid hotel.
Results are cached, so repeated calls with an identical request body return identical copy.
Note: This is a beta feature and may be subject to changes.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Invalid request: missing or malformed hotelId, unsupported language, or count outside 1-10 / not matching highlights length.
The hotelId was not found.
Too Many Requests - Rate limit exceeded (10 requests per minute per API key).
Technical failure fetching hotel data.