TripAdvisor API

TripAdvisor cruises

Cruises sailing a region, twenty per page, with ship, line, ports, itinerary, sailings and the ship's rating; without a destination, the list of regions.

Read as Markdown Use with an AI agent

Endpoint

GET/v1/tripadvisor/cruiseslimited capacity1 credit

Try in Playground

Limited capacity: this operation currently relies on small shared monthly allowances. Availability can end before your account credits are used. Contact support before scheduling or bulk use. Allowances are shared across customers and related operations; this is not a per-account entitlement.

Parameters

Query parameters

Name	Required	Description	Example
`destination_id`	no	Cruise region id (147237 is the Caribbean); the region directory upstream is unreliable, so prefer the id	`147237`
`destination`	no	Region name, matched against the directory when it answers
`sort`	no	popularity, departure_date, price, length or ship	`popularity`
`month`	no	Departure month, YYYY-MM
`page`	no	Page number (20 per page)	`1`
`currency`	no	Currency code	`USD`
`dry_run`	no	Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution.	`1`

Examples

Make the request

curl

curl "https://www.monocrawl.com/v1/tripadvisor/cruises" \
  -H "x-api-key: mn_your_key_here"

TypeScript

typescript

const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/tripadvisor/cruises",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);

Python

python

import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/tripadvisor/cruises",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

200 · application/json

{
  "success": true,
  "platform": "tripadvisor",
  "endpoint": "/v1/tripadvisor/cruises",
  "data": {
    "_warnings": [
      "example"
    ],
    "count": 0,
    "cursor": null,
    "destination": {
      "id": "example"
    },
    "filters": {
      "cruiseLength": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "cruiseLines": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "cruiseStyle": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "dealsType": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "departingFrom": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "port": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ],
      "ship": [
        {
          "count": 0,
          "id": "example",
          "name": "example"
        }
      ]
    },
    "has_more": false,
    "items": [
      {
        "arrival_port": "example",
        "cruise_line": {
          "id": "example",
          "logo": "example",
          "name": "example"
        },
        "departure_port": "example",
        "departure_ports": [
          "example"
        ],
        "destination": {
          "id": "example",
          "image": "https://example.com/example",
          "name": "example"
        },
        "id": "example",
        "itinerary": [
          {}
        ],
        "nights": 0,
        "platform": "example",
        "rating": {
          "max": 0,
          "value": 0,
          "votes": 0
        },
        "review_snippets": [
          "example"
        ],
        "reviews_count": 0,
        "sailings": [
          {}
        ],
        "sailings_count": 0,
        "ship": {
          "amenities": [
            "example"
          ],
          "crew": 0,
          "highlights": {},
          "image": "https://example.com/example",
          "launched": 0,
          "passengers": 0
        },
        "ship_id": "example",
        "ship_name": "example",
        "ship_url_name": "https://example.com/example",
        "title": "example",
        "type": "example",
        "url": "https://example.com/example"
      }
    ],
    "page": 0,
    "total": 0,
    "total_pages": 0
  },
  "credits_used": 1,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

Field inside data	Type	Meaning
`_warnings`	`array \| null`	Optional warnings supplied by this operation. Null means unknown.
`count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`cursor`	`string \| null`	Opaque next-page token; pass it back unchanged. Null does not prove complete history.
`destination`	`object \| null`	Optional destination supplied by this operation. Null means unknown.
`destination.id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters`	`object \| null`	Optional filters supplied by this operation. Null means unknown.
`filters.cruiseLength`	`array \| null`	Optional cruiseLength supplied by this operation. Null means unknown.
`filters.cruiseLength[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.cruiseLength[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.cruiseLength[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.cruiseLines`	`array \| null`	Optional cruiseLines supplied by this operation. Null means unknown.
`filters.cruiseLines[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.cruiseLines[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.cruiseLines[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.cruiseStyle`	`array \| null`	Optional cruiseStyle supplied by this operation. Null means unknown.
`filters.cruiseStyle[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.cruiseStyle[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.cruiseStyle[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.dealsType`	`array \| null`	Optional dealsType supplied by this operation. Null means unknown.
`filters.dealsType[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.dealsType[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.dealsType[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.departingFrom`	`array \| null`	Optional departingFrom supplied by this operation. Null means unknown.
`filters.departingFrom[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.departingFrom[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.departingFrom[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.port`	`array \| null`	Optional port supplied by this operation. Null means unknown.
`filters.port[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.port[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.port[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`filters.ship`	`array \| null`	Optional ship supplied by this operation. Null means unknown.
`filters.ship[].count`	`number \| null`	Number of records in this response, not lifetime or total matches.
`filters.ship[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`filters.ship[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`has_more`	`boolean \| null`	Source continuation indicator; null means unknown.
`items`	`array \| null`	Returned records. Source coverage and completeness vary.
`items[].arrival_port`	`string \| null`	Optional arrival port supplied by this operation. Null means unknown.
`items[].cruise_line`	`object \| null`	Optional cruise line supplied by this operation. Null means unknown.
`items[].cruise_line.id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`items[].cruise_line.logo`	`string \| null`	Optional logo supplied by this operation. Null means unknown.
`items[].cruise_line.name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`items[].departure_port`	`string \| null`	Optional departure port supplied by this operation. Null means unknown.
`items[].departure_ports`	`array \| null`	Optional departure ports supplied by this operation. Null means unknown.
`items[].destination`	`object \| null`	Optional destination supplied by this operation. Null means unknown.
`items[].destination.id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`items[].destination.image`	`string \| null`	Optional image supplied by this operation. Null means unknown.
`items[].destination.name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`items[].id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`items[].itinerary`	`array \| null`	Optional itinerary supplied by this operation. Null means unknown.
`items[].nights`	`number \| null`	Optional nights supplied by this operation. Null means unknown.
`items[].platform`	`string \| null`	Optional platform supplied by this operation. Null means unknown.
`items[].rating`	`object \| null`	Source rating; read its accompanying scale and vote count.
`items[].rating.max`	`number \| null`	Optional max supplied by this operation. Null means unknown.
`items[].rating.value`	`number \| null`	Optional value supplied by this operation. Null means unknown.
`items[].rating.votes`	`number \| null`	Optional votes supplied by this operation. Null means unknown.
`items[].review_snippets`	`array \| null`	Optional review snippets supplied by this operation. Null means unknown.
`items[].reviews_count`	`number \| null`	Optional reviews count supplied by this operation. Null means unknown.
`items[].sailings`	`array \| null`	Optional sailings supplied by this operation. Null means unknown.
`items[].sailings_count`	`number \| null`	Optional sailings count supplied by this operation. Null means unknown.
`items[].ship`	`object \| null`	Optional ship supplied by this operation. Null means unknown.
`items[].ship.amenities`	`array \| null`	Optional amenities supplied by this operation. Null means unknown.
`items[].ship.crew`	`number \| null`	Optional crew supplied by this operation. Null means unknown.
`items[].ship.highlights`	`object \| null`	Optional highlights supplied by this operation. Null means unknown.
`items[].ship.image`	`string \| null`	Optional image supplied by this operation. Null means unknown.
`items[].ship.launched`	`number \| null`	Optional launched supplied by this operation. Null means unknown.
`items[].ship.passengers`	`number \| null`	Optional passengers supplied by this operation. Null means unknown.
`items[].ship_id`	`string \| null`	Optional ship id supplied by this operation. Null means unknown.
`items[].ship_name`	`string \| null`	Optional ship name supplied by this operation. Null means unknown.
`items[].ship_url_name`	`string \| null`	Optional ship url name supplied by this operation. Null means unknown.
`items[].title`	`string \| null`	Source title when supplied.
`items[].type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`items[].url`	`string \| null`	Original source URL when supplied.
`page`	`number \| null`	Optional page supplied by this operation. Null means unknown.
`total`	`number \| null`	Source-reported total; null is unknown.
`total_pages`	`number \| null`	Optional total pages supplied by this operation. Null means unknown.

Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.

The example is invented and illustrates types only; zero and empty values are not claims about a real result.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

TripAdvisor cruises

Query parameters

Make the request

Response fields and example

More TripAdvisor reference

First call in under a minute