Overview
Beta Feature - Check a customer-written hotel description against LiteAPI hotel data. The check compares the text with the hotel's static record (name, description, important information, facilities, rooms, policies, location, stars, and nearby places) and with stored guest-review sentiment. It does not fetch live reviews.
Access: enterprise API keys only. Other keys receive 403.
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 returns 429 Too Many Requests.
What You Get
verdict:passwhen there are no flags,reviewwhen there is a minor or unverified flag and no red flag,failwhen any flag is red. The verdict is computed from the flags.confidence: the model's certainty in that judgment, from 0 to 1. It is not a second verdict and it is not a writing-quality score.flags: concrete claims in the submitted text.
Flag severity
red: the text contradicts hotel data or stored sentiment.evidencequotes the contradicting fact.minor: the text matches hotel data but overstates it (distance, star level, or policy strength).evidenceis set.unverified: a concrete fact in the text that our data neither supports nor contradicts.evidenceis null. A swimming pool that is absent from facilities, rooms, the hotel description, important information, and sentiment is unverified, not red.
Marketing with no checkable fact (perfect getaway, unforgettable stay) produces no flag.
description is rejected above 20,000 characters. It is not truncated. language selects the language of summary and each explanation and defaults to en. The description itself may be any language.
Hotel facts are resolved server-side from hotelId. A child property is checked against its parent record. The response hotelId is the id you sent.
If the model call fails, the endpoint returns 500. It does not return a pass it did not compute.
Note: This is a beta feature and may be subject to changes.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Invalid request: missing or malformed hotelId, empty or over-cap description, or unsupported language.
401Authentication required.
403The API key is not an enterprise key. Hotel description evaluation is available to enterprise accounts only.
404The hotelId was not found.
429Too Many Requests - Rate limit exceeded (10 requests per minute per API key).
500Technical failure fetching hotel data or evaluating the description. A model failure is never returned as a pass.

