Content API

API Services for REST / JSON:

List Available Points: https://wetu.com/API/Pins/<APIKEY>/List

Get Detailed Information: https://wetu.com/API/Pins/<APIKEY>/Get

Search Available Points: https://wetu.com/API/Pins/<APIKEY>/Search/<TERMS>

Get Pins with paging::https://wetu.com/API/Pins/<APIKEY>/GetPinsWithPaging

You can also query a paged result set by changing the request endpoint to https://wetu.com/API/Pins/SAMPLE/GetPinsWithPaging?pageNumber=1

This endpoint adds one extra parameter, which is the page number you are looking for.

Each result set will be limited to 1000 results.

Get Service

The Get service allows you to filter down to a specific subset by a combination of two possible

query parameters:

modifiedsince (ISO8601 date value)

- returns only points modified after that date
- e.g. https://wetu.com/API/Pins/SAMPLE/Get?modifiedsince=2015-10-15T00:00:00

ids (comma separated list of numeric ids for points)

- returns only those explicit points
- e.g. https://wetu.com/API/Pins/SAMPLE/Get?ids=1197,3733

You can also request content in a different language (default English) by appending using the lang query parameter. Please note that the behavior of this will vary depending on which options have been configured on the account - notably whether Machine Translations are enabled, and whether untranslated (i.e. English) content should be provided if not translation is available.

lang (ISO 639-1 language codes)

- returns text in the language if available
- e.g. https://wetu.com/API/Pins/SAMPLE/Get?ids=1197,3733&lang=de

List

The List service has a four optional query parameters:

all=include

- return activities, restaurants and other content types in addition to accommodation

owned=y

- filter results down to only content owned or added by the operator (not typically necessary)

suppliers=y

- filter results down to only content included in the suppliers list (i.e. only the “active” set of content in-use by the operator)

countries=AU,ZA

- filters results down to only content in the provided countries
- country codes are standard ISO 3166-1 Alpha-2 codes
- multiple country codes should be comma separated

modifiedsince (ISO8601 date value)

- returns only points modified after that date
- e.g. https://wetu.com/API/Pins/SAMPLE/Get?modifiedsince=2015-10-15T00:00:00

Search

The Search service has a single optional query parameter:

all=include

- return activities, restaurants and other content types in addition to accommodation

The SOAP variant is available at: https://wetu.com/API/Pins.asmx (append ?wsdl for metadata if needed). For the REST variant, parameters may also be passed as POST values.

If you'd like to see an example of the content available, here is a formatted response for one of our better populated properties: https://wetu.com/API/Pins/SAMPLE/Get?ids=3733

Images referred to in the API are available raw; or can be requested scaled or cropped from our internal image scaler.

Image Scaler

The image scaler url structure is: http://wetu.com/ImageHandler/<SIZE>/<URL_FRAGMENT>

The size format is one of the following:

cWxH

- Crop image to fit fully into the frame. Crop is taken from middle, preserving as much of the image as possible.
- http://wetu.com/ImageHandler/c400x300/3733/EVilla_Deck_Evening2.jpg

hWxH

- As above, but resize to height first, then crop on width only if needed.
- http://wetu.com/ImageHandler/h400x300/3733/EVilla_Deck_Evening2.jpg

wWxH

- As above, but resize to width first, then crop on height only if needed.
- http://wetu.com/ImageHandler/w400x300/3733/EVilla_Deck_Evening2.jpg

WxH

- Resize the image to fit within the frame. Image will not exceed specified dimensions, but will most likely be smaller on one of them.
- http://wetu.com/ImageHandler/400x300/3733/EVilla_Deck_Evening2.jpg

nWxH

- As above, but do not upscale the image.
- http://wetu.com/ImageHandler/n400x300/3733/EVilla_Deck_Evening2.jpghttp://wetu.com/ImageHandler/n400x300/3733/EVilla_Deck_Evening2.jpg

nfWxH

- As above, but pad the image with white to ensure the resolution matches the frame.
- http://wetu.com/ImageHandler/nf400x300/3733/EVilla_Deck_Evening2.jpg

For convenience, the API already provides the image url_fragment alongside the full image url. All you need to to do is decide on the resolution and crop behavior you need in a given situation, and append that fragment. Please note the leading / is not included in the fragment.

Data Structures

The REST / JSON and SOAP / XML versions of the API use different naming standards for properties. Documented below are the SOAP / XML values, for REST / JSON simply convert these to snake case (e.g. MapObjectId becomes map_object_id).

Pin primary type - the API will return an array of these see also Accommodation \| Activity \| ConferenceVenue \| Restaurant \| Person \| Destination
MapObjectId	int	Unique identifier used within Wetu. This field is being renamed within Wetu, documentation for other systems may refer to this as a ContentEntityId.
Name	string
Status	string	Enhanced, Managed or Unmanaged. Enhanced and Managed properties are content managed directly by their owners / operators.
LastModified	string	ISO8601 Date/Time; indicates last time the content was updated.
Type	string	Classification of content type - Accommodation is most frequently encountered. Other options are Destination, Activity, Person, Restaurant, Information or Area.
Category	string	Further classification of above.
Subcategory	string	Specialised classification for activities.
Position	Position	Geographic location, including GPS coordinates and country / region labels.
Content	Content	Images, videos, descriptions, 360 panoramas
Documentation	Documentation (array)
Specials	Specials (array)
AffiliateName	string	identifies the primary booking / availability engine used
AffiliateCode	string	identifier for above system
AffiliateInterface	string	secondary / group identifier for certain engines

Accommodation _{(extends Pin)}
Features	Features_Accommodation
Rooms	Room (array)
Units	Unit (array)
Activities	SimpleItem (array)
SpaOptions	SimpleItem (array)
Restaurants	SimpleItem (array)

Activity _{(extends Pin)}
Features	Features_Activity
Options	Option (array)

ConferenceVenue _{(extends Pin)}
Features	Features_ConferenceVenue
Venues	ConferenceVenueRoom (array)
Packages	ConferencePackage (array)

Restaurant _{(extends Pin)}
Features	Features_Restaurant

Person _{(extends Pin)}
Features	Features_Person
PersonImage	Image

Destination _{(extends Pin)}
DestinationImage	Image

Important Note: Wetu-provided destination images are not available through the Content API due to licensing restrictions. Custom images loaded through Hybrid Content are distributed through the API as normal.

Country _{(extends Destination)}
TravelInformation	TravelInformation	Travel guidance, such as currency, visa, health and safety.

TravelInformation
Health	string	Health / Medical Information
Safety	string	Safety Notices
Electricity	string	Electricity and Plug Standards
Banking	string	Banking and Currency
Visa	string	Visa Regulations and Guidance
Cuisine	string	Food, Drink and Cuisine Advice
Climate	string	Climate and Weather
Transport	string	Travel, Transport and Getting Around
Dress	string	Clothing / Dress Recommendations
AdditionalInfo	string	General Guidance

Position _{(extends Pin)}
Latitude	double	geographic location of property, suitable for showing on a map
Longitude	double
DrivingLatitude	double	alternate location useable for routing (to avoid being routed to rear entrances / nearby roads)
DrivingLongitude	double
Country	string
Region	string	province / state / administrative region
Area	string	town / city
Location	string	suburb
Destination	string	Wetu tourism region

Features_Accommodation
StarAuthority	string	body / organisation providing star grading below
Stars	int
Rating	string	descriptive rating label
Rooms	int
CheckInTime	string	e.g. 09h00
CheckOutTime	string
SpokenLanguages	string (array)
SpecialInterests	string (array)
SuggestedVisitorTypes	string (array)
PropertyFacilities	string (array)
RoomFacilities	string (array)
AvailableServices	string (array)
ActivitiesOnSite	string (array)
ActivitiesOffSite	string (array)

Features_Activity
MaxGroupSize	int
SpokenLanguages	string (array)
Facilities	string (array)
SuggestedVisitorTypes	string (array)
WeatherRequirement	string (array)
SpecialInterests	string (array)
OperatingHours	OperatingHours

Features_ConferenceVenue
StarAuthority	string	body / organisation providing star grading below
Stars	int
Rating	string	descriptive rating label
Rooms	int
PaxAccommodationOnSite	int	maximum number of people that can be accommodated on site
PaxAccommodationOffSite	int	maximum number of people that can be accommodated at nearby partner properties
SpokenLanguages	string (array)
ConferenceFacilities	string (array)
ConferenceEquipment	string (array)
PropertyFacilities	string (array)
RoomFacilities	string (array)
AvailableServices	string (array)
ActivitiesOnSite	string (array)
ActivitiesOffSite	string (array)

Features_Restaurant
Seats	int	total guest capacity
SpokenLanguages	string (array)
Cuisine	string (array)
Ambiance	string (array)
Facilities	string (array)
OperatingHours	OperatingHours

Features_Person
Languages	string (array)	spoken languages
Skills	string (array)
Regions	string (array)	geographic areas of specialty
SpecialInterests	string (array)

Content _{(extends Pin)}
GeneralDescription	string	standard description, may contain HTML
ExtendedDescription	string	longer description, may contain HTML
TeaserDescription	string	short teaser description, may contain HTML
ContactInformation	ContactInformation	email addresses, phone numbers, website, booking and skype addresses
Images	Image (array)
YoutubeVideos	Video (array)
Panoramas	Panorama (array)
Logo	Image

OperatingHours
MondayOpen	string
MondayClose	string
TuesdayOpen	string
TuesdayClose	string
WednesdayOpen	string
WednesdayClose	string
ThursdayOpen	string
ThursdayClose	string
FridayOpen	string
FridayClose	string
SaturdayOpen	string
SaturdayClose	string
SundayOpen	string
SundayClose	string
OpenPublicHolidays	boolean
ByAppointment	boolean

ContactInformation
Email	string
Telephone	string	general contact number (may be to a central booking office)
Skype	string
WebsiteUrl	string
Address	string
Facebook	string
Twitter	string
BookingsUrl	string	url for webpage with direct booking capability
MobileBookingsUrl	string	url for mobile-optimised web page with direct booking capability
FrontDeskTelephone	string	direct number of front desk at property

Image
Url	string	full url to image
UrlFragment	string	partial image url, intended for use with Image Scaler
Label	string	short label for image
Description	string	longer description
Credit	string	photographer / provider credit
Width	int
Height	int
Size	int	bytes

Video
Url	string	full url to video page
EmbedUrl	string	embed appropriate url, for iframe
Label	string	title
Description	string	longer description

Panorama many panoramas require Flash for display; avoid using them on mobile devices
Url	string	embed appropriate url, for iframe
Label	string	title
Description	string	longer description

SimpleItem
Id	string	Unique identifier for this content item, useful for room types
Name	string
Description	string
Images	Image (array)

Room _{(extends SimpleItem)}
PerPersonSharingRates	ItemRate (array)	pricing (per person)
SingleRates	ItemRate (array)	pricing (single)
RoomRates	ItemRate (array)	pricing (per room)
Amenities	string (array)
AffiliateCode	string	external booking system identifier

Unit _{(extends SimpleItem)}
UnitRates	ItemRate (array)	pricing (per unit)
Amenities	string (array)
AffiliateCode	string	external booking system identifier

Option _{(extends SimpleItem)}
OptionRates	ItemRate (array)	pricing

ConferenceVenueRoom _{(extends SimpleItem)}
CapacityReception	int	attendee capacity if venue is configured as reception hall
CapacityTheatre	int	attendee capacity if venue is configured as theatre
CapacityClassroom	int	attendee capacity if venue is configured as classroom
CapacityBanquet	int	attendee capacity if venue is configured as banquet hall
CapacityBanquetDanceFloor	int	attendee capacity if venue is configured as banquet hall with dance floor
CapacityBoardroom	int	attendee capacity if venue is configured as boardroom
CapacityUShaped	int	attendee capacity if venue is configured with U-shaped seating
EntranceHeight	double	metres
EntranceWidth	double	metres
DimensionsLength	double	metres
DimensionsWidth	double	metres
VenueHireRates	ItemRate (array)	pricing

ConferencePackage _{(extends SimpleItem)}
Rates	ItemRate (array)

ItemRate indicates a pricing / rate
Start	string	ISO8601 Date/Time
End	string	ISO8601 Date/Time
Type	string
Currency	string	ISO4217 (e.g. USD / GBP)
Rate	double
Conditions	string
Included	string

Documentation _{(extends Pin)}
Section	string	grouping label for documentation
Label	string	title
Url	string	url to document

Specials _{(extends Pin)}
Name	string
Type	string	special classification
Description	string	full text
Start	string	ISO8601 Date/Time
End	string	ISO8601 Date/Time
Conditions	string

Please contact Wetu to obtain an API Key.
enterprise@wetu.com

Content API

The API is available as either a SOAP webservice (XML) or a RESTful endpoint returning JSON data.

API Services for REST / JSON:

Get Service

List

Search

Image Scaler

Data Structures

Pin

Accommodation _{(extends Pin)}

Activity _{(extends Pin)}

ConferenceVenue _{(extends Pin)}

Restaurant _{(extends Pin)}

Person _{(extends Pin)}

Destination _{(extends Pin)}

Country _{(extends Destination)}

TravelInformation

Position _{(extends Pin)}

Features_Accommodation

Features_Activity

Features_ConferenceVenue

Features_Restaurant

Features_Person

Content _{(extends Pin)}

OperatingHours

ContactInformation

Image

Video

Panorama

SimpleItem

Room _{(extends SimpleItem)}

Unit _{(extends SimpleItem)}

Option _{(extends SimpleItem)}

ConferenceVenueRoom _{(extends SimpleItem)}

ConferencePackage _{(extends SimpleItem)}

ItemRate

Documentation _{(extends Pin)}

Specials _{(extends Pin)}

Content API

The API is available as either a SOAP webservice (XML) or a RESTful endpoint returning JSON data.

API Services for REST / JSON:

Get Service

List

Search

Image Scaler

Data Structures

Pin

Accommodation (extends Pin)

Activity (extends Pin)

ConferenceVenue (extends Pin)

Restaurant (extends Pin)

Person (extends Pin)

Destination (extends Pin)

Country (extends Destination)

TravelInformation

Position (extends Pin)

Features_Accommodation

Features_Activity

Features_ConferenceVenue

Features_Restaurant

Features_Person

Content (extends Pin)

OperatingHours

ContactInformation

Image

Video

Panorama

SimpleItem

Room (extends SimpleItem)

Unit (extends SimpleItem)

Option (extends SimpleItem)

ConferenceVenueRoom (extends SimpleItem)

ConferencePackage (extends SimpleItem)

ItemRate

Documentation (extends Pin)

Specials (extends Pin)

Accommodation _{(extends Pin)}

Activity _{(extends Pin)}

ConferenceVenue _{(extends Pin)}

Restaurant _{(extends Pin)}

Person _{(extends Pin)}

Destination _{(extends Pin)}

Country _{(extends Destination)}

Position _{(extends Pin)}

Content _{(extends Pin)}

Room _{(extends SimpleItem)}

Unit _{(extends SimpleItem)}

Option _{(extends SimpleItem)}

ConferenceVenueRoom _{(extends SimpleItem)}

ConferencePackage _{(extends SimpleItem)}

Documentation _{(extends Pin)}

Specials _{(extends Pin)}