Evaluate a hotel description (Beta)

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: pass when there are no flags, review when there is a minor or unverified flag and no red flag, fail when 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. evidence quotes the contradicting fact.
  • minor: the text matches hotel data but overstates it (distance, star level, or policy strength). evidence is set.
  • unverified: a concrete fact in the text that our data neither supports nor contradicts. evidence is 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Unique ID of the hotel (liteAPI format).

string
required

Customer-written hotel description to check. Maximum 20,000 characters.

string

Language of the summary and flag explanations. Defaults to en. The description may be in any language.

Responses

400

Invalid request: missing or malformed hotelId, empty or over-cap description, or unsupported language.

401

Authentication required.

403

The API key is not an enterprise key. Hotel description evaluation is available to enterprise accounts only.

404

The hotelId was not found.

429

Too Many Requests - Rate limit exceeded (10 requests per minute per API key).

500

Technical failure fetching hotel data or evaluating the description. A model failure is never returned as a pass.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json