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,…
Headers
Get your API keyAPI key (`sfk_...`)
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
Only cruises with a sailing that month, as `YYYY-MM`, e.g. `2027-01`.
pattern: ^20\d\d-(0[1-9]|1[0-2])$
Only cruises offering this cabin: `inside`, `oceanview`, `balcony` or `suite`.
one of: inside, oceanview, balcony, suite
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
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_-]+$
Endpoint-specific response payload.
`not_found` when no cruise matches: the geo id is not a cruise destination, or the filters leave nothing.
one of: found, not_found
The geo id asked for.
Cruises matching the search, as the site counts them.
Cruises on this page, most popular first. Prices are not included.
The site's id for the cruise.
The cruise's name, e.g. `7 NIGHT Caribbean - Western CRUISE`.
Length in nights.
Region it sails, e.g. `Caribbean - Western`.
Port it leaves from, e.g. `Galveston`.
Port it ends at.
The cruise line that runs it.
Tripadvisor's id for the cruise line.
Cruise line, e.g. `MSC Cruises`.
The ship that sails it.
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.
Ship, e.g. `MSC Seascape`.
The ship's Tripadvisor page.
Average traveller rating of the ship, 1 to 5.
Reviews of the ship.
Ship photo URL. Link only; not hosted by Social Fetch.
Day by day, in order.
Day of the cruise, from 1.
Port of call, or `Cruising` for a day at sea.
Upcoming departures, earliest first.
The site's id for the sailing.
Day the sailing leaves, as `YYYY-MM-DD`.
Pagination state for the current page.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Position of this page's first row in the full list.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.