Tripadvisor hub

Tripadvisor Cruise Reviews API

A cruise ship's reviews, newest first, 5 a page as the site shows them.

GET /v1/tripadvisor/cruise-ships/{locationId}/reviews

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

GET /v1/tripadvisor/cruise-ships/{locationId}/reviews lists a cruise ship's reviews, 5 a page as the site shows them. locationId is the d number in the ship's Tripadvisor address (15691572 is Royal Caribbean's Liberty of the Seas).

Each review carries id, url, title, text, rating (1 to 5), publishedAt and the author (name, username, profile, avatar). The site's cruise pages give the month a review was posted (2026-10), not the day, and show no aspect ratings, trip type or owner replies, so those fields are empty. Past the first page, text is a snippet of about 280 characters, as the cruise pages show it, not the full review. data.totalCount counts the ship's English reviews, the list the page shows. Pass page.nextCursor back as cursor while page.hasMore is true.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Tripadvisor Cruise Reviews API FAQ

Why is publishedAt only a month?

The site's cruise pages show the month a review was posted, not the day, so publishedAt is YYYY-MM.

Why are tripType and ownerResponse empty?

Cruise reviews on the site carry no aspect ratings, trip type or owner replies. The review shape is the same as for hotels, restaurants and attractions, so those fields are null or empty.

Is the review text complete?

Not always. The site's cruise pages shorten reviews: past the first page, text is a snippet of about 280 characters, not the full review.

What if no ship has the id?

HTTP 200 with data.lookupStatus not_found and an empty list. Check lookupStatus before storing rows.

How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.