Tripadvisor

Get Tripadvisor cruise ship

Get a Tripadvisor cruise ship by location id, with its cruise line, rating breakdown, passengers, crew, cabins, activities and dining.

GET/v1/tripadvisor/cruise-ships/{locationId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
locationIdintegerrequiredpath

Tripadvisor location id, e.g. `93450`: the `d` number in a place's Tripadvisor address, or `locationId` from search.

≥ 1 · ≤ 2147483647

Response fields
34

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no cruise ship has this id.

one of: found, not_found

datalocationId
integer

The location id asked for.

A Tripadvisor cruise ship.

datashiplocationId
integer

Tripadvisor location id of the ship.

datashipname
string

The ship's name with its cruise line's.

datashipurl
string

The ship's Tripadvisor page.

The cruise line that runs the ship.

datashipcruiseLineid
integer

Tripadvisor's id for the cruise line.

datashipcruiseLinename
string

Cruise line, e.g. `Royal Caribbean`.

datashiprating
numbernullable

Average traveller rating, 1 to 5.

datashipreviewCount
integernullable

Reviews in every language.

How many reviews gave each rating, 1 to 5.

datashipratingCounts1
integernullable

Reviews rating it 1.

datashipratingCounts2
integernullable

Reviews rating it 2.

datashipratingCounts3
integernullable

Reviews rating it 3.

datashipratingCounts4
integernullable

Reviews rating it 4.

datashipratingCounts5
integernullable

Reviews rating it 5.

datashipimage
stringnullable

Main photo URL. Link only; not hosted by Social Fetch.

datashippassengers
integernullable

Passenger capacity.

datashipcrew
integernullable

Crew members.

datashiplaunched
integernullable

Year the ship was launched.

datashipcabins
integernullable

Number of cabins.

Activities on board, e.g. `Fitness Center`.

datashipactivities[]
stringoptional

Restaurants and bars on board.

datashipdining[]name
string

Venue, e.g. `Grand Dining Room`.

datashipdining[]kind
stringnullable

What it serves, as the site words it, e.g. `Steakhouse`.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/tripadvisor/cruise-ships/15691572" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Tripadvisor cruise ship.