The office is now closed until the 2nd January 2025, but for urgent technical support please email support@widgety.co.uk.

The Widgety Cruise API

The Widgety Cruise API is the largest of its kind, featuring itineraries, pricing, availability (where provided), ship content and ports visited, from over 60 cruise lines around the world. 

All of the content on the Widgety platform can be requested through the Cruise API, including 1,000 ships, brochures, trade resources, and tens of thousands of images. 

Create your own bespoke cruise solution to suit your business.

Designed from the ground up to be as flexible as possible, the Widgety API aims to provide all of the content available on the platform in a way that allows customers to use it on their own websites and solutions. This ensures that the content you are interested in featuring will update on your website without you having to ever look at it.

 

If you would like a test API key please contact us. You will be able to use our developer website to understand and experience the API without needing to commit or invest in full development.

Cruise API - Get Cruises

Every itinerary, every port called at, every fare set, flights from regional airports, the number of days, whether it’s fly-cruise or cruise only, additional passengers, themes, daily descriptions, and every available price, all tied in to the ship and operator information. 

See all the parameters for a cruise.

A cruise reference gets you everything about one or more cruises. A range of filters have been built in to help, similar to ships; you can search for cruises starting from or calling in at certain ports, include a date range, and filter by type of cruise. 
 
We have headline pricing for inside, outside, balcony and suite grades, which always shows the lowest available fare for that cabin type. This saves on calculating the logic yourself.
 
Unique to the Widgety Cruise API, we have linked cabin grades and names to the information on the ships, allowing you to get a full picture of the ship and what’s included in the fare. 
The parameters available for fare sets within a cruise.
An example of the port of call parameters.

Cruise API - Get Operators

There are more than 60 cruise operators on the Widgety API, with every cruise, ship, image, resource and more available. 

See the full list of the cruise lines we work with. 

A single request can get the operator information in full including their ships, brochures and images.

You can also make a request for any operators that have itineraries starting from, or calling at, a specific port. 

This allows you to quickly build content based on a specific destination or cruise line. 

See all the available parameters for an operator request.

Cruise API - Get Ships

From the largest ships in the world to tiny charter yachts, you can find information about everything from accommodation on board to dietary requirements, and which plug sockets are in the cabins. 

You can make a request to get every ship on the platform, but there are lots of additional filters built into the API to allow you to make very specific requests as well. 

You can filter by any field, such as adult-only ships, those that have butler service on board, or only ships that can cater for a passenger with mobility problems. The possibilities are endless. 

See the full list of ship parameters. 

An example of the accommodation stats parameters
Example of the information for each port in the Cruise API.

Cruise API - Ports

We’ve done the mapping, so you don’t have to. Everywhere in the world, mapped to an exact location; no messy duplications or confusing names. 

Port visits for a cruise can be requested separately from the cruise itself.

Every port in the API has an accurate latitude and longitude, and an official UNLOCODE where available. 

Day number and timings are included if they’re provided, as is the daily programme that a cruise line provides to explain what the itinerary is for each specific day. If that’s not available, we have our own port information. 

Ports is a growing part of the platform and operator-specific images, copy and credits will be available soon.

Access the Cruise API

Not got your own developers? Here are our third-party solutions who have done the work for you.

KEY BENEFITS

Flexible

The API allows you to create your own bespoke solutions to suit you. In-built filters make it easy to be as specific, or as broad, as you like.

Scalable

Quickly change and upgrade the content you pull from Widgety as your business grows and the market changes.

Supported

Our friendly support team can help with any issues you face, and the Widgety sales team can make sure you're using the Cruise API to the fullest.

Cruise Itineraries & Pricing

Widgety works with the majority of ocean and river cruise lines selling in the UK. We have integrated direct feeds and flat files from those cruise lines into our API, allowing you to access up to date itineraries, pricing, availability and cabin grades where available.

If you have entered your APP Key and Token on the developer website, a ‘Cruise Lines Integrations’ section will show, which will lead you to our Content website. This site provides information about each of our integrations, including how often it is updated, as well as any specific information related to each of them.

Operators & Ships

There are over 60 cruise line operators in Widgety with more than 1,000 ocean and river cruise ships.

Cruise operator information includes brochures, members club information, social media and video links, reasons to book and images.

Cruise ship information is split into the following sections: basic information, dining, entertainment, accommodation, kids facilities, health & fitness, enrichment and useful to know.

Each section is in turn split up into the different facilities available for them, with applicable images and attachments. 

Thousands of Images

There are over 60,000 images, brochures, files and attachments available via the API, attached to tour operators, cruise lines, their ships, ports, and itineraries.

Widgety works directly with operators to ensure all imagery on the platform is royalty free and we include any credits where needed.

To help optimise your website, and save you time, we have built in the ability to request multiple images at the size, quality, and compression to suit you.

Resized and requested once by you, automatically kept up to date by us

Consumer & Trade Resources

Every cruise line and tour operator, ocean and river cruise ships, trade events and destinations can have brochures and attachments. Ships have menus and deckplans, covid policies and selling guides.

Thumbnails are automatically generated as soon as a file is uploaded into our system, stored on our Amazon Web Server alongside the original file.

All operator brochures are classified and have a drop-off date, making sure that you never see or feature any out of date information. All menus and similar attachments on ships are allocated to the facility they relate to, so you can easily see the menu for a specific spa or restaurant.

Ready to Learn more?

Get in touch