Skip to main content
POST
Trip.com Reviews

Request contract

  • Method and path: POST /apis/v1/trip/reviews
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/trip/reviews
  • Runtime facts: 36cd348dfbeebb651c2c303746468cec77d2c6553836f33de18c2a778433a67c
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
geoCode
string
required

Two-letter ISO 3166-1 country code of the proxy the page is fetched through, e.g. 'US', 'SG'. Use the target site's own country (e.g. 'ID' for lazada.co.id, 'TH' for th.hotels.com): it sets the localized prices, currency, language and availability.

Pattern: ^[A-Za-z]{2}$
hotelId
string
required

Trip.com hotel id, the hotelId in the hotel page URL (e.g. '3267031'). Reviews come back for THIS id even if url names another hotel.

Pattern: ^\d+$
url
string<uri>
required

Full Trip.com page URL, e.g. https://us.trip.com/hotels/...

locale
string

Review language, e.g. 'en-US', 'id-ID' (default 'en-US').

Minimum string length: 2
page
integer

Review page, starting at 1 (default 1).

Required range: 1 <= x <= 9007199254740991
pageSize
integer

Reviews per page, up to 100 (default 100).

Required range: 1 <= x <= 100

Response

Normalized successful response

data
object
required