Tripadvisor

Search Tripadvisor cruises

Search Tripadvisor cruises to a destination, most popular first, with ship, cruise line, ports, day-by-day itinerary and departure dates; filter by month,…

GET/v1/tripadvisor/cruises
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
geoIdintegerrequiredquery

Tripadvisor geo id of the cruise destination, e.g. `147237` (Caribbean) or `28923` (Alaska): the `g` number in a Tripadvisor address, or `locationId` of a `geo` search result.

≥ 1 · ≤ 2147483647

departureMonthstringoptionalquery

Only cruises with a sailing that month, as `YYYY-MM`, e.g. `2027-01`.

pattern: ^20\d\d-(0[1-9]|1[0-2])$

cabinTypestringoptionalquery

Only cruises offering this cabin: `inside`, `oceanview`, `balcony` or `suite`.

one of: inside, oceanview, balcony, suite

lengthstringoptionalquery

Only cruises of this length in days: `1-2`, `3-5`, `6-9`, `10-14`, `15+` or `weekend`.

one of: 1-2, 3-5, 6-9, 10-14, 15+, weekend

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.

min 1 chars · max 1024 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
37

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no cruise matches: the geo id is not a cruise destination, or the filters leave nothing.

one of: found, not_found

datageoId
integer

The geo id asked for.

datatotalCount
integernullable

Cruises matching the search, as the site counts them.

Cruises on this page, most popular first. Prices are not included.

datacruises[]id
integer

The site's id for the cruise.

datacruises[]title
string

The cruise's name, e.g. `7 NIGHT Caribbean - Western CRUISE`.

datacruises[]nights
integernullable

Length in nights.

datacruises[]destination
stringnullable

Region it sails, e.g. `Caribbean - Western`.

datacruises[]departurePort
stringnullable

Port it leaves from, e.g. `Galveston`.

datacruises[]arrivalPort
stringnullable

Port it ends at.

The cruise line that runs it.

datacruises[]cruiseLineid
integer

Tripadvisor's id for the cruise line.

datacruises[]cruiseLinename
string

Cruise line, e.g. `MSC Cruises`.

The ship that sails it.

datacruises[]shiplocationId
integernullable

Tripadvisor location id of the ship: pass it to the cruise ship endpoints. Null for a new ship the site has no page for yet.

datacruises[]shipname
string

Ship, e.g. `MSC Seascape`.

datacruises[]shipurl
stringnullable

The ship's Tripadvisor page.

datacruises[]shiprating
numbernullable

Average traveller rating of the ship, 1 to 5.

datacruises[]shipreviewCount
integernullable

Reviews of the ship.

datacruises[]shipimage
stringnullable

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

Day by day, in order.

datacruises[]itinerary[]day
integer

Day of the cruise, from 1.

datacruises[]itinerary[]port
string

Port of call, or `Cruising` for a day at sea.

Upcoming departures, earliest first.

datacruises[]sailings[]id
integer

The site's id for the sailing.

datacruises[]sailings[]departureDate
string

Day the sailing leaves, as `YYYY-MM-DD`.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Pass as `cursor` to get the next page; null on the last page.

datapageoffset
integer

Position of this page's first row in the full list.

≥ 0

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/cruises?geoId=147237" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Cruises to a Tripadvisor destination.