The Widgety API
A fully flexible, easy to use, all-in-one multi currency REST API for Cruise and Touring with detailed itineraries, pricing, availability, cruise ships & destination content.
Are you a travel agent or IT provider looking to build your own bespoke holiday solution without the hassle of regularly updating content?
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 make live requests and get instant results, allowing you to understand and experience the API without needing to commit or invest in full development.
There are two versions of the Widgtey API:
Our Cruise API, also known as V2, includes cruise pricing, itineraries, availability (where provided) and ship content, in GBP.
V2 is available now.
Our Holidays API, or V3, is brand new and brings together cruise and touring, with pre and post packages, multi-market options and multi-currencies.
V3 is currently in Beta and will be available soon.
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 80 cruise line operators in Widgety with more than 1000 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 and holidays.
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.
Cruises & Tours Together
- pre and post packages
- transport options
- operator-specific imagery for itineraries
Dive Deep Into Tours
As we upgrade cruise lines this summer and add in new tour operators, the new API will include pre and post holiday extensions.
Tours will feature meals included, number of days, the operating season, age ranges, comfort ratings, group sizes and transport options.
The itineraries themselves will indicate what type of travel will happen each day, whether it be cruise, land, rail or air. Cruise elements will seamlessly link to the cruise ship content, allowing you, for example, to get information about a specific cabin alongside its advertised price. This will allow us to make the most of our core product.
Multiple Markets, Multiple Currencies
Our new API will see all operators upgraded to show holidays in all currencies offered, for every market they sell to.
Unbundling A Cruise
Cruise is where Widgety started and the new API will feature an upgrade to cruises to offer a
- text based detailed explanation of all fare sets
- what’s included on a cruise
- pre and post cruise extensions
The API also brings together availability, pricing and cabin information to allow detailed searches for cruises available on ships with cabins that offer specific facilities such as a bath, interlocking cabins or a butler service.
Easy Access to New Operators
Our new comprehensive dashboard will keep your sales, marketing and IT team up to date with new operators coming onboard, as well as new holidays, changes and cancellations. It will also allow you to easily request and gain access to new operators without needed to call or email us to update your API Key.
API Product Comparison - Available Content
|Cruises API (V2)||Holidays API (V3)|
|Get full holiday details||-||1 per holiday (includes dates and pricing)|
|Get all departure information||2 per departure||2 per holiday (all departures) or 1 per departure|
|Get all applicable itineraries for a holiday||-||✔|
|Breakdown by operating seasons||-||✔|
|Markets & Languages (when available)|
|Pricing for individual markets||✔||✔|
|Localised descriptions||-||✔||when available|
|Holiday Details (when available)|
|Links||One link only||✔|
|Single Occupancy||✔||✔||when available|
|Triple Occupancy||✔||✔||when available|
|Quad Occupancy||-||✔||when available|
|Infant + Children||-||✔||when available|
|Transport information||✔||✔||when available|
|Transport pricing||✔||✔||when available|
|Transport class||-||✔||when available|
|Cabin Name (cruise only)||✔||✔|
|Cabin Code (cruise only)||✔||✔|
|Cabin Type (cruise only)||-||✔|
|Ship information (for Cruise Holidays)|
|Accommodation breakdown by cabin||✔||✔|
|Ability to connect pricing to individual cabin description||✔||✔|
|One request for all Itineraries||-||✔|
|Breakfast/Lunch/Dinner inclusion||-||✔||when available|
|Day type (cruise, flight, land)||-||✔|
|Day title||-||✔||when available|
|General day description||✔||✔||when available|
|UNLOCODE mapped locations (incl. lat/longs and country)||✔||✔|
|Operator location descriptions||✔||✔||when available|
|Operator location imagery||-||✔||when available|
|Widgety-sourced location imagery||-||✔||when available|
|Accommodation rating||-||✔||when available|
|Accommodation description||-||✔||when available|
|Accommodation imagery||-||✔||when available|