Tripadvisor Cruise Ship API
One cruise ship with its line, ratings, size and what is on board, by location id.
GET /v1/tripadvisor/cruise-ships/{locationId}1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/tripadvisor/cruise-ships/{locationId} reads one cruise ship. locationId is the d number in the ship's Tripadvisor address (Cruise_Review-d15691572-… is 15691572, Royal Caribbean's Liberty of the Seas).
data.ship carries name, url, the cruiseLine (id and name), rating, reviewCount, ratingCounts (reviews per star), image, passengers, crew, launched, cabins, activities on board and dining, each venue with its name and kind (Main Dining Room, American).
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.
Example response
A 200 response. Live responses have the same shape with current data.
Tripadvisor Cruise Ship API FAQ
Where do I find a ship's id?
It is the d number in the ship's Tripadvisor address: Cruise_Review-d15691572-Reviews-Royal_Caribbean_Liberty_of_the_Seas is 15691572.
What if no ship has the id?
HTTP 200 with data.lookupStatus not_found and data.ship null. Hotel, restaurant and attraction ids are not_found here too.
How do I get the ship's reviews?
Call GET /v1/tripadvisor/cruise-ships/{locationId}/reviews with the same id.
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.
Other Tripadvisor endpoints
- SearchGET /v1/tripadvisor/search
- Place by URLGET /v1/tripadvisor/place
- Hotels in a cityGET /v1/tripadvisor/hotels
- Restaurants in a cityGET /v1/tripadvisor/restaurants
- Attractions in a cityGET /v1/tripadvisor/attractions
- Attraction types in a cityGET /v1/tripadvisor/attractions/types
- Cruise searchGET /v1/tripadvisor/cruises
- Cruise ship reviewsGET /v1/tripadvisor/cruise-ships/{locationId}/reviews