---
title: Content API
description: "Wetu Content API: the API is available as either a SOAP webservice (XML) or a RESTful endpoint returning JSON data."
---

[![](https://knowledge.wetu.com/hubfs/Knowledge%20Base%20Header%20Media/Inverted_withouttagline.png)](https://wetu.com)

[Contact Us](mailto:support@wetu.com)

[Skip to content](https://knowledge.wetu.com/content-api#main-content)

Open main navigation

Close main navigation

- [Contact us](mailto:support@wetu.com)

[Contact us](mailto:support@wetu.com)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledgebase](https://knowledge.wetu.com/?hsLang=en)
2. [Integrations & Enterprise Solutions](https://knowledge.wetu.com/integrations-enterprise-solutions?hsLang=en)
3. [Wetu APIs & Technical Docs](https://knowledge.wetu.com/integrations-enterprise-solutions?hsLang=en#wetu-apis-technical-docs)

May 25, 2026

# Content API

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

 

### **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](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](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/>[https://wetu.com/API/Pins/SAMPLE/Get?ids=1197,3733](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](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](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](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](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](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](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](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](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.jpg](http://wetu.com/ImageHandler/n400x300/3733/EVilla_Deck_Evening2.jpg)http://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](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*](https://knowledge.wetu.com/content-api#Accomodation) *\|* [*Activity*](https://knowledge.wetu.com/content-api#Activity) *\|* [*ConferenceVenue*](https://knowledge.wetu.com/content-api#ConferenceVenue) *\|* [*Restaurant*](https://knowledge.wetu.com/content-api#Restaurant) *\|* [*Person*](https://knowledge.wetu.com/content-api#Person) *\|* [*Destination*](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#Position) | Geographic location, including GPS coordinates and country / region labels. |
| Content | [**Content**](https://knowledge.wetu.com/content-api#Content) | Images, videos, descriptions, 360 panoramas |
| Documentation | [**Documentation**](https://knowledge.wetu.com/content-api#Documentation) (array) |  |
| Specials | [**Specials**](https://knowledge.wetu.com/content-api#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](https://knowledge.wetu.com/content-api#pin)) |  |
| --- | --- |
| Features | [**Features\_Accommodation**](https://knowledge.wetu.com/content-api#Features_Accommodation) |
| Rooms | [**Room**](https://knowledge.wetu.com/content-api#Room) (array) |
| Units | [**Unit**](https://knowledge.wetu.com/content-api#unit) (array) |
| Activities | [**SimpleItem**](https://knowledge.wetu.com/content-api#Simpleltem) (array) |
| SpaOptions | [**SimpleItem**](https://knowledge.wetu.com/content-api#Simpleltem) (array) |
| Restaurants | [**SimpleItem**](https://knowledge.wetu.com/content-api#Simpleltem) (array) |

 

| #### **Activity** (extends [Pin](https://knowledge.wetu.com/content-api#pin)) |  |
| --- | --- |
| Features | [**Features\_Activity**](https://knowledge.wetu.com/content-api#Features_Activity) |
| Options | **Option** (array) |

 

| #### **ConferenceVenue** (extends [Pin](https://knowledge.wetu.com/content-api#pin)) |  |
| --- | --- |
| Features | **Features\_ConferenceVenue** |
| Venues | **ConferenceVenueRoom** (array) |
| Packages | **ConferencePackage**(array) |

 

| #### **Restaurant** (extends [Pin](https://knowledge.wetu.com/content-api#pin)) |  |  |
| --- | --- | --- |
| Features | [**Features\_Restaurant**](https://knowledge.wetu.com/content-api#Features_Restaurant) |  |

 

| #### **Person** (extends [Pin](https://knowledge.wetu.com/content-api#pin)) |  |  |
| --- | --- | --- |
| Features | [**Features\_Person**](https://knowledge.wetu.com/content-api#Features_Person) |  |
| PersonImage | [**Image**](https://knowledge.wetu.com/content-api#Image) |  |

 

| #### **Destination** (extends [Pin](https://knowledge.wetu.com/content-api#pin)) |  |  |
| --- | --- | --- |
| DestinationImage | [**Image**](https://knowledge.wetu.com/content-api#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](https://knowledge.wetu.com/content-api#Destination)) |  |  |
| --- | --- | --- |
| TravelInformation | [**TravelInformation**](https://knowledge.wetu.com/content-api#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](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#OperatingHours) |  |

 

| #### **Features\_Person** |  |  |
| --- | --- | --- |
| Languages | string (array) | spoken languages |
| Skills | string (array) |  |
| Regions | string (array) | geographic areas of specialty |
| SpecialInterests | string (array) |  |

 

| #### **Content** (extends [Pin](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#ContactInformation) | email addresses, phone numbers, website, booking and skype addresses |
| Images | [**Image**](https://knowledge.wetu.com/content-api#Image) (array) |  |
| YoutubeVideos | [**Video**](https://knowledge.wetu.com/content-api#Video) (array) |  |
| Panoramas | [**Panorama**](https://knowledge.wetu.com/content-api#Panorama) (array) |  |
| Logo | [**Image**](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#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**](https://knowledge.wetu.com/content-api#Image) (array) |  |

 

 

| #### **Room** (extends [SimpleItem](https://knowledge.wetu.com/content-api#Simpleltem)) |  |  |
| --- | --- | --- |
| PerPersonSharingRates | **[ItemRate](https://knowledge.wetu.com/content-api#ItemRate)** (array) | pricing (per person) |
| SingleRates | [**ItemRate**](https://knowledge.wetu.com/content-api#ItemRate) (array) | pricing (single) |
| RoomRates | [**ItemRate**](https://knowledge.wetu.com/content-api#ItemRate) (array) | pricing (per room) |
| Amenities | string (array) |  |
| AffiliateCode | string | external booking system identifier |

 

| #### **Unit** (extends [SimpleItem](https://knowledge.wetu.com/content-api#Simpleltem)) |  |  |
| --- | --- | --- |
| UnitRates | [**ItemRate**](https://knowledge.wetu.com/content-api#ItemRate) (array) | pricing (per unit) |
| Amenities | string (array) |  |
| AffiliateCode | string | external booking system identifier |

 

 

| #### **Option** (extends [SimpleItem](https://knowledge.wetu.com/content-api#Simpleltem)) |  |  |
| --- | --- | --- |
| OptionRates | [**ItemRate**](https://knowledge.wetu.com/content-api#ItemRate) (array) | pricing |

 

| #### **ConferenceVenueRoom** (extends [SimpleItem](https://knowledge.wetu.com/content-api#Simpleltem)) |  |  |
| --- | --- | --- |
| 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**](https://knowledge.wetu.com/content-api#ItemRate) (array) | pricing |

 

| #### **ConferencePackage** (extends [SimpleItem](https://knowledge.wetu.com/content-api#Simpleltem)) |  |  |
| --- | --- | --- |
| Rates | [**ItemRate**](https://knowledge.wetu.com/content-api#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](https://knowledge.wetu.com/content-api#pin)) |  |  |
| --- | --- | --- |
| Section | string | grouping label for documentation |
| Label | string | title |
| Url | string | url to document |

 

| #### **Specials** (extends [Pin](https://knowledge.wetu.com/content-api#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**](mailto:enterprise@wetu.com)

 

- Home
- Products
- Pricing
- Blog
- Company

[![Brand\_Pillar\_Icons\_set-1](https://knowledge.wetu.com/hs-fs/hubfs/Brand_Pillar_Icons_set-1.png?width=240&height=80&name=Brand_Pillar_Icons_set-1.png "Brand_Pillar_Icons_set-1")](http://wetu.com)

 **Contact Support**: **[support@wetu.com](mailto:support@wetu.com)** [mailto:support@wetu.com](mailto:support@wetu.com)