ArrivalGuides API Docs

This document briefly describes the methods in the ArrivalGuides API.

To get a specific version of the api, please use the URL-parameter v.

The current API-version is 3.

AllDownloadLinks (Lite API)

The lite API provides a convenient way of fetching all download links either as xml or csv.

Parameters

lang [string] (optional) Two letter language code

format [string] (optional) The format. Defaults to 'xml' but can also be 'csv'.

Example query

https://api.arrivalguides.com/api/lite/AllDownloadLinks?auth={PARTNER_API_KEY}&lang=en&form
at=csv

Sample response

iso,destination_name,lang_iso,lang_name,dl_url,destination_url
AARHUS,Aarhus,EN,English (United States),http://ag.com/...,http://www.ag.com/...
ABERDEEN,Aberdeen,EN,English (United States),http://ag.com/...,http://www.ag.com/...
ABERDEEN,Aberdeen,SV,Swedish (Sweden),http://ag.com/...,http://www.ag.com/...
ABUDHABI,Abu Dhabi,EN,English (United States),http://ag.com/...,http://ag.com/...
...

AllTravelguides
Get a list of all travelguides grouped by continent and country.

Parameters

auth [string] authentication code

lang [string] Two letter language code

Example query

https://api.arrivalguides.com/api/xml/AllTravelguides?auth={PARTNER_API_KEY}&lang=en

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<Continents>
<Continent NameInEnglish="Africa" Name="Africa">
<Country CountryCode="MA" Name="Morocco">
<Destination ISO="FES">
<AvailableLanguages>
<Language ISO="EN">English (United States)</Language>
</AvailableLanguages>
<Name>Fes</Name>
<ContentMax>
http://api.arrivalguides.com/Widget/ContentMax/Get/?ISO=FES
</ContentMax>
<DestinationPage>
http://www.arrivalguides.com/en/Travelguides/Africa/Morocco/FES
</DestinationPage>
</Destination>
</Country>
...
</Continent>
...
</Continents>

Travelguide
Get a complete travelguide

Parameters

auth [string] authentication code

lang [string] Two letter language code
iso [string] destination ISO
imgWidth [integer] (optional)
imgHeight [integer] (optional)
thumbWidth [integer] (optional)
thumbHeight [integer] (optional)

Example query

https://api.arrivalguides.com/api/xml/Travelguide?auth={PARTNER_API_KEY}&lang=en&iso=STOCKH
OLM&imgWidth=420&imgHeight=252&thumbWidth=74&thumbHeight=74

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<destination iso="STOCKHOLM">
<Name>Stockholm</Name>
<destinationpartner>
<name>Stockholm Visitors Board</name>
<image>
http://api.arrivalguides.com/Content/data/Destinations/stockholm_png_w420_h-1_fa.jpg
</image>
</destinationpartner>
<destinationAd>
<image>
http://api.arrivalguides.com/Content/img/app/STOCKHOLM/columbus_en_320x480.jpg
</image>
</destinationAd>
<icon url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_front_large_w
74_h74cr.jpg" />
<facts>
<Currency>SEK Svenska kronor 1 kr = 100 öre</Currency>
<EmergencyNumbers>112</EmergencyNumbers>
<Newspapers>
 ...
</Newspapers>
<OpeningHours>
...
</OpeningHours>
<Population>2.1 million in the region.</Population>
<TouristInformation>
...
</TouristInformation>
<Website>
http://www.visitstockholm.com
</Website>
</facts>
<Location>
<lat>59.3327881</lat>
<lon>18.0644881</lon>
</Location>
<slideshow>
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_front_larg
e_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_thecity_la
rge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_doandsee_l
arge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_citycard_l
arge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_events_lar
ge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_eating_lar
ge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_cafes_larg
e_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_barsandnig
htlife_large_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_shopping_l
arge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_sleeping_l
arge_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_spaandfitn
ess_large_w420_h252cr.jpg" />
<image url="http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_camping_la
rge_w420_h252cr.jpg" />
</slideshow>
<description>
...
</description>
<sections>
 <section id="18063" name="Do &amp; See" iso="doandsee" url="http://www.arrivalguides.co
m/en/Travelguides/Europe/Sweden/STOCKHOLM/doandsee">
<image>
http://api.arrivalguides.com/Content/data/Destinations/STOCKHOLM_doandsee_large_w
320_h215cr.jpg
</image>
<description>
...
</description>
<specialoffers>
<offer>
<url>http://spritmuseum.se</url>
<imageurl>
http://api.arrivalguides.com/Content/img/app/STOCKHOLM/spritmuseum/290x192.jp
g
</imageurl>
<Location>
<lat>59.3053482</lat>
<lon>18.2813966</lon>
</Location>
<poi />
</offer>
</specialoffers>
<pointsofinterest>
<entry>
<id>18568</id>
<likes>0</likes>
<title>Stockholms stadsmuseum</title>
<description>
...
</description>
<Location>
<lat>59.32893</lat>
<lon>18.0649100000001</lon>
</Location>
<meta type="address">Ryssgården</meta>
<meta type="phone">+46 8 508 31 620</meta>
<meta type="www">www.stadsmuseum.stockholm.se</meta>
<meta type="openinghours">Tues – Sun 11 – 17 Thur 11 -20 Mon Closed</meta>
<meta type="moreinfo"></meta>
<meta type="subway"></meta>
<meta type="tickets"></meta>
</entry>
...
</pointsofinterest>
</section>
...
</sections>
 <Campaigns>
<Campaign>
<Id>4ef9c6a7d460340e4078217c</Id>
<Name>3 Cafés</Name>
<Description>Claim your favorite Cafés in whatever city you like</Description>
<ImageUrl></ImageUrl>
<PoiIds />
<Claimed />
<Price>
<IsToken>true</IsToken>
<ImageUrl />
<Text>Once you have claimed your three favorite cafes you can enjoy a free download
</Text>
</Price>
<RequiredPois>3</RequiredPois>
<Destinations />
<SectionIds>
<SectionId>154</SectionId>
</SectionIds>
<Type>Category</Type>
</Campaign>
</Campaigns>
</destination>

Travelguides
Get a list of travelguides.

Parameters

auth [string] authentication code

lang [string] Two letter language code
country [string] Two-letter language code or english country name.
continent [string] Any of: europe, north_america, africa, central_america, asia, south_amer
ica, oceania
imgWidth [integer] (optional)
imgHeight [integer] (optional)
thumbWidth [integer] (optional)
thumbHeight [integer] (optional)
Example query

https://api.arrivalguides.com/api/xml/Travelguides?auth={PARTNER_API_KEY}&lang=en&country=s
e&continent=europe&imgWidth=300&imgHeight=200&thumbWidth=74&thumbHeight=74

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<continent continentInEnglish="Europe" name="Europe">
<description>...</description>
<facts>
<FunFacts>... </FunFacts>
<NumCountries>45</NumCountries>
<Population>730 million</Population>
<Weather>... </Weather>
</facts>
<image url="http://api.arrivalguides.dev/Content/data/Destinations/Europe_w320_h139cr.jpg
"/>
<countries>
<country>
<name>Albania</name>
<englishName>Albania</englishName>
<image url="http://api.arrivalguides.dev/Content/data/Destinations/TIRANA_front_large
_w79_h74cr.jpg"/>
</country>
<country>
<name>Austria</name>
<englishName>Austria</englishName>
<image url="http://api.arrivalguides.dev/Content/data/Destinations/SALZBURG_front_lar
ge_w79_h74cr.jpg"/>
</country>
</countries>
</continent>

GetAllDestinations
Get a list of all destinations with a short description.
Parameters

auth [string] authentication code

Example query

https://api.arrivalguides.com/api/xml/GetAllDestinations?auth={PARTNER_API_KEY}

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?><destinations>

<destination iso="AARHUS" index="1">
<name>Aarhus</name>
<image url="http://api.arrivalguides.com/Content/data/Destinations/AARHUS_front_large_w
79_h74cr.jpg" />
<description>With the describing slogan of being the world’s smallest big city, Aarhus
is petite enough for one to be acquainted with the place in a short time, yet large enough
to fill the days and nights with lively activities and events. The mixture of youthful opti
mism and creativity, together with the city’s good old-fashioned cosiness, create a unique
atmosphere making a visit to Aarhus a pleasant and uplifting experience.</description>
</destination>
<destination iso="ABERDEEN" index="2">
<name>Aberdeen</name>
<image url="http://api.arrivalguides.com/Content/data/Destinations/ABERDEEN_front_large
_w79_h74cr.jpg" />
<description>Known as the Granite City because of the locally quarried stone, Aberdeen,
the capital of northeastern Scotland, is one of the most distinctive cities in Great Britai
n. Surrounded by magnificent scenery, it mixes a rich history, handsome granite architectur
e and traditional industries with a flurry of leisure and entertainment amenities. It has a
vibrant arts scene, a cosmopolitan atmosphere and one of the most buoyant economies in the
country. Scotland’s third largest city truly has something to offer for everyone.</descript
ion>
</destination>
...

Search
Search among the destinations.

Parameters

auth [string] authentication code

lang [string] Two letter language code
q [string] search query string
limit [integer] limit the number of results (optional)
skip [integer] skip a number of results (optional)

Example query

https://api.arrivalguides.com/api/xml/Search?auth={PARTNER_API_KEY}&lang=en&q=south&limit=2
&skip=2

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?><destinations>

<destination iso="CAPETOWN" index="1">
<name>Cape Town</name>
<image url="http://api.arrivalguides.com/Content/data/Destinations/CAPETOWN_front_w79_h
74cr.jpg" />
<description>
...
</description>
</destination>
...
</destinations>

TravelguideByLocation
Get the closest travelguide by location

Paramters
auth [string] authentication code
lat [double] latitude
lng [douvle] longitude

Example query

https://api.arrivalguides.com/api/xml/TravelguideByLocation?auth={PARTNER_API_KEY}&lat=59.3
3&lon=18.07

Sample response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<destination iso="STOCKHOLM">
<destinationpartner>
<name>Stockholm Visitors Board</name>
<image>
http://api.arrivalguides.com/Content/data/Destinations/stockholm_png_w420_h-1_fa.jpg
</image>
</destinationpartner>
</destination>
...