NAV Navbar
Logo
shell

Introduction

Welcome to the ArrivalGuides Content API! You can use the API for access all ArrivalGuides travel guide content.

The API is versioned and the latest version is 13. Please include the parameter v=13 when making requests.

Authentication

To authenticate, use this code:

# With shell, you can just pass the correct URL parameter with each request
curl "api_endpoint_here?auth=YOUR_API_KEY"

Make sure to replace YOUR_API_KEY with your API key.

To access the API, you need a key. This will be provided to you by your technical contact.

The API expects the API key to be included in all requests to the server as a URL parameter.

auth=YOUR_API_KEY

Travelguides

The following method are used for listing and fetching general destination content.

List all travel guides

This method fetches all travel guides.

curl "https://api.arrivalguides.com/api/xml/AllTravelguides?auth=YOUR_API_KEY&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Continents>
  <Continent NameInEnglish="Africa" Name="Africa">
    <Country CountryCode="MA" Name="Morocco">
      <Destination ISO="DAKAR">
        <AvailableLanguages>
          <Language ISO="EN">English (United Kingdom)</Language>
        </AvailableLanguages>
        <Name>Dakar</Name>
        <ContentMax>https:///docs</ContentMax>
        <DestinationPage>
          https://arrivalguides.com/en/Travelguides/Africa/Senegal/DAKAR
        </DestinationPage>
        <LastModified>2016-06-27T12:32:16Z</LastModified>
        <Iatas/>
        <Images>
          <image url=".../1.jpg" description="" copyright="" copyrightLink=""/>
          <image url=".../2.jpg" description="" copyright="" copyrightLink=""/>
        </Images>
        <Categories>
          <Category Id="4" Name="I Love Culture"/>
          <Category Id="5" Name="Historical destinations"/>
        </Categories>
      </Destination>
      ...
    </Country>
    ...
  </Continent>
  ...
</Continents>

This endpoint fetches all travel guides.

HTTP Request

GET https://api.arrivalguides.com/api/xml/AllTravelguides?auth=YOUR_API_KEY&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
lang string Two letter language code

Fetch a specific travel guide

Get a complete travelguide. This can be done either by ISO or IATA. If you need to find a guide based on any other parameter (like country or coordinates) please see the other queries listed further down in this document.

curl "https://api.arrivalguides.com/api/xml/Travelguide?auth=YOUR_API_KEY&lang=en&iso=LONDON&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<destination iso="LONDON">
  <name>London</name>
  <availableLanguages>
    <meta type="lang">en</meta>
    ...
  </availableLanguages>
  <icon url="http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/16/4ccda7ed46eecae1a649ff4ff40d4828.jpg?width=420&amp;height=252&amp;mode=crop" description="Aerial panoramic cityscape view of London." copyright="Engel Ching/Shutterstock.com" copyrightLink="" />
  <facts>
    <currency>British pounds, £1 = 100 pence</currency>
    <emergencyNumbers>999</emergencyNumbers>
    <newspapers>The Times
The Telegraph
The Guardian
Daily Mail
The Independent
London Evening Standard</newspapers>
    <openingHours>Typical shopping hours are Monday-Saturday 9.00-17.30. Many department stores stay open till 18.00, some till 19.00 or 20.00 on Wednesdays or Thursdays. Larger shops are often open 10.00-18.00 on Sundays.</openingHours>
    <population>8.3 million</population>
    <touristInformation>City Information Centre
St. Paul's Churchyard, 
London,
EC4M 8BX
+44 20 7332 1456</touristInformation>
    <website />
  </facts>
  <location>
    <lat>51.508515</lat>
    <lon>-0.125487</lon>
  </location>
  <tags />
  <slideshow>
    <image url="http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/16/4ccda7ed46eecae1a649ff4ff40d4828.jpg?width=420&amp;height=252&amp;mode=crop" description="Aerial panoramic cityscape view of London." copyright="Engel Ching/Shutterstock.com" copyrightLink="" />
    ...
  </slideshow>
  <description>London is the cultural, political and economic heart of Britain, famous for world-class museums, galleries, royal palaces, shopping destinations, West End theatre shows and award-winning restaurants...</description>
  <sections>
    <section id="14661" name="The City" iso="thecity" link="https://www.arrivalguides.com/en/Travelguides/Europe/United Kingdom/LONDON/thecity">
      <images>
        <image url="http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/07/c588d9a7741ff01c8c65b7c148f826b2.jpg?width=420&amp;height=242&amp;mode=crop" description="Financial District of London and the Tower Bridge" copyright="QQ7/Shutterstock.com" copyrightLink="" />
      </images>
      <description>London is a world-class city and the heart of British politics, culture and commerce...</description>
      <pointsofinterest />
    </section>
    <section id="9837" name="Events Not To Be Missed" iso="events" link="https://www.arrivalguides.com/en/Travelguides/Europe/United Kingdom/LONDON/events">
      <images>
        <image url="http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/04/4f75604d8f7b306ff42b8872648844fc.jpg?width=420&amp;height=242&amp;mode=crop" description="Westminster Bridge at sunset" copyright="ESB Professional/Shutterstock.com" copyrightLink="" />
      </images>
      <description>London has a full calendar of events, covering many different interests. This guide highlights the must-see events that take place in London throughout the year.</description>
      <pointsofinterest>
        <entry>
          <id>81264</id>
          <title>Changing the Guard at Buckingham Palace</title>
          <description>Changing the Guard or Guard Mounting involves an exchange of guard duties at Buckingham Palace. Watch the ceremony as each set of guards dressed in traditional red tunics and bearskin hats takes over from their brothers-in-arms. You can also see the process at Horse Guards Arch on Horse Guards Parade.</description>
          <location>
            <lat>51.501364</lat>
            <lon>-0.141889999999989</lon>
          </location>
          <link>http://www.arrivalguides.com/en/Travelguide/London/events/changing-the-guard-at-buckingham-palace-81264</link>
          <meta type="address">Buckingham Palace, London SW1A 1AA </meta>
          <meta type="email"></meta>
          <meta type="phone"></meta>
          <meta type="www"></meta>
          <meta type="openinghours">11.30am daily at Buckingham Palace. 11.00am (10.00am on Sundays) daily at Horse Guards Parade.</meta>
          <meta type="moreinfo"></meta>
          <meta type="subway">Green Park Tube station</meta>
          <meta type="tickets">Free to enter</meta>
          <meta type="googlePlaceId"></meta>
          <images>
            <image url="http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/16/059756108f6e907d25d5d0d924561b79.jpg?width=300&amp;height=300&amp;mode=crop" description="Detail of Queen's Soldier" copyright="Iacopo Guidi/Shutterstock.com" copyrightLink="" />
          </images>
        </entry>
        ...
      </section>
      ...
  </sections>
  <iatas>
    <iata>LHR</iata>
    ...
  </iatas>
</destination>

HTTP Request

GET https://api.arrivalguides.com/api/xml/Travelguide?auth=YOUR_API_KEY&lang=en&iso=LONDON&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication Key
lang string Two letter language code
iso string True Destination ISO
iata string Airport IATA
imgWidth integer Image width
imgHeight integer Image height
thumbWidth integer Thumbnail width
thumbHeight integer Thumbnail height

Search among the destinations.

curl "https://api.arrivalguides.com/api/xml/Search?auth=YOUR_API_KEY&lang=en&q=goth&limit=2&skip=2&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<destinations>
  <destination iso="GOTHENBURG" index="1">
    <name>Gothenburg</name>
    <image />
    <description>The beauty of Gothenburg is seen as you walk around the harbour and city centre, exploring the different neighborhoods that lend the area a nice, relaxing feel. There are cafés on every street corner and world-class restaurants serving the freshest ingredients. Gothenburg offers year-round events and attractions like the Liseberg amusement park and the Opera, sporting events, the annual film festival, book fair the Way Out West music festival and much more.</description>
    <lastupdated>0001-01-01T00:00:00</lastupdated>
    <location lat="0" lon="0" />
  </destination>
  ...
</destinations>

Search among the destinations.

HTTP Request

GET https://api.arrivalguides.com/api/xml/Search?auth=YOUR_API_KEY&lang=en&q=goth&limit=2&skip=2&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
lang string True Two letter language code
q string True Search query string
limit integer Limit the number of results
skip integer Skip a number of results

Get All Destinations

Fetch a list of all destinations.

curl "https://api.arrivalguides.com/api/xml/GetAllDestinations?auth=YOUR_API_KEY&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<destinations>
  <destination iso="LACORUNA" index="1">
    <name>A Coruña</name>
    <image />
    <description>A Coruña is a busy and attractive city at the very tip of Galicia. This is a perfect place to enjoy a gentle stroll around the streets and avenues, where it is possible to discover Roman architecture as well as more modern innovative buildings. The atmosphere in the many magnificent town squares is excellent and full of the joy of life on a hot summer’s day. Outside the town centre the beaches, the marina, the fishing port and the commercial port still play a very important role for the people of A Coruña.</description>
    <lastupdated>2016-01-19T14:01:05Z</lastupdated>
    <location lat="43.3708731" lon="-8.39583500000003" />
  </destination>
  ...
</destinations>

Fetch a list of all destinations.

HTTP Request

GET https://api.arrivalguides.com/api/xml/GetAllDestinations?auth=YOUR_API_KEY&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key

Travelguide by location

Get the closest travelguide by location.

curl "https://api.arrivalguides.com/api/xml/TravelguideByLocation?auth=YOUR_API_KEY&lat=59.33&lng=18.07&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<destination iso="STOCKHOLM">
  <destinationpartner>
    <name>Stockholm</name>
    <image>...01.jpg</image>
  </destinationpartner>
</destination>

Get the closest travelguide by location.

HTTP Request

GET https://api.arrivalguides.com/api/xml/TravelguideByLocation?auth=YOUR_API_KEY&lat=59.33&lng=18.07&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
lat double True Latitude
lng double True Longitude
limit integer Limit the number of results
maxDistance double The max radius from the given point (meters)

List travelguides by continent and country

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

curl "https://api.arrivalguides.com/api/xml/AllTravelguides?auth=YOUR_API_KEY&lang=en&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Continents>
  <Continent NameInEnglish="Africa" Name="Africa">
    <Country CountryCode="MA" Name="Morocco">
      <Destination ISO="DAKAR">
        <AvailableLanguages>
          <Language ISO="EN">English (United Kingdom)</Language>
        </AvailableLanguages>
        <Name>Dakar</Name>
        <ContentMax>https:///docs</ContentMax>
        <DestinationPage>
          https://arrivalguides.com/en/Travelguides/Africa/Senegal/DAKAR
        </DestinationPage>
        <LastModified>2016-06-27T12:32:16Z</LastModified>
        <Iatas/>
        <Images>
          <image url=".../1.jpg" description="Dakar Senegal - Looking North" copyright="Jeff Attaway" copyrightLink="http://bit.ly/28ZQcTQ"/>
          <image url=".../2.jpg" description="Atlantic ocean coastline in Dakar, Senegal" copyright="Igor Grochev/Shutterstock.com" copyrightLink=""/>
          <image url=".../3.jpg" description="Senegal's pink water lake called Lake Retba or Lac Rose, north of the Cap Vert peninsula of Senegal, north east of Dakar" copyright="Anton_Ivanov/Shutterstock.com" copyrightLink=""/>
          <image url=".../4.jpg" description="Street with old red houses at the coast of Goree island, Dakar, Senegal" copyright="Vladimir Zhoga/Shutterstock.com" copyrightLink=""/>
        </Images>
        <Categories>
          <Category Id="4" Name="I Love Culture"/>
          <Category Id="5" Name="Historical destinations"/>
        </Categories>
      </Destination>
      ...
    </Country>
    ...
  </Continent>
  ...
</Continents>

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

HTTP Request

GET https://api.arrivalguides.com/api/xml/AllTravelguides?auth=YOUR_API_KEY&lang=en&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
lang string Two letter language code

Videos

The following method are used for listing and fetching video content.

List all videos

Lists all the videos available in our system.

The Url to access the source files is pre-signed for access and is valid for one day from the point when the API request was made.

curl "https://api.arrivalguides.com/api/xml/GetAllVideos?auth=YOUR_API_KEY&videoWidth=1280&videoHeight=720&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<videos>
  <video id="7" destination="ALICANTE">
    <title>Alicante...</title>
    <description>Discover ...</description>
    <thumbnail>http://www.dailymotion.com/thumbnail/video/x18mtn5</thumbnail>
    <link>http://www.dailymotion.com/embed/video/x18mtn5?autoPlay=1</link>
    <embed><![CDATA[<iframe ...></iframe>]]></embed>
    <url>https://ag-videos-processed.s3-eu-west-1.amazonaws.com/.../</url>
    <specs>
      <duration>210</duration>
      <framerate>24.99</framerate>
      <width>1920</width>
      <height>1080</height>
    </specs>
    <tags>
      <tag>Destination</tag>
      <tag>city</tag>
      <tag>beautiful</tag>
    </tags>
    <themes>
      <theme id="1" title="With your kids"/>
      <theme id="2" title="Lazy beach days"/>
      <theme id="3" title="Shopper's Paradise"/>
      <theme id="4" title="I Love Culture"/>
      <theme id="5" title="Historical Destinations"/>
      <theme id="8" title="Vibrant"/>
    </themes>
    <stats>
        <totalViews>2149</totalViews>
        <lLastWeekViews>38</lastWeekViews>
    </stats>
  </video>
  ...
</videos>

Lists all the videos available in our system.

HTTP Request

GET https://api.arrivalguides.com/api/xml/GetAllVideos?auth=YOUR_API_KEY&videoWidth=1280&videoHeight=720&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
videoWidth integer Video iframe width
videoHeight integer Video iframe height

Get videos for a specific destination

Lists the videos associated with a specific destination. The Destination can be identified by either its ISO or IATA. The video is presented as an iFrame to either DailyMotion or Youtube depending on the preference of the destination partner. Please note that the language string (“lang”) will default to English if it is not defined. Most videos have English as its set language, only a few of our videos have other languages as its spoken language.

The Url to access the source files is pre-signed for access and is valid for one hour from the point when the API request was made.

curl "https://api.arrivalguides.com/api/xml/GetVideosFor?auth=YOUR_API_KEY&iso=LONDON&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<videos>
  <video id="169" destination="STOCKHOLM">
    <title>Stockholm - it's not a coincidence!</title>
    <description>Charlie Caper's magic take on Stockholm...</description>
    <thumbnail>http://www.dailymotion.com/thumbnail/video/x1vlq7m</thumbnail>
    <link>http://www.dailymotion.com/embed/video/x1vlq7m_stockholm-it-s-not-a-coincidence_travel?autoPlay=1</link>
    <embed><![CDATA[<iframe ...></iframe>]]></embed>
    <url>https://ag-videos-processed.s3-eu-west-1.amazonaws.com/.../</url>
    <specs>
      <duration>226</duration>
      <framerate>24.99</framerate>
      <width>1280</width>
      <height>720</height>
    </specs>
    <tags>
    <tag>Musical</tag>
    <tag>London</tag>
    <tag>West End</tag>
    <tag>Entertainment</tag>
    <tag>The Lion King</tag>
    <tag>Wicked</tag>
    <tag>Charlie and the Chocolate Factory</tag>
    <tag>The Commitments</tag>
    <tag>Book of Mormon</tag>
    <tag>Les Misérables</tag>
    <tag>Billy Elliot the Musical</tag>
    <tag>thriller</tag>
    <tag>Mamma Mia!</tag>
    <tag>The Phantom of the Opera</tag>
    </tags>
    <themes>
      <theme id="1" title="With your kids"/>
      <theme id="4" title="I Love Culture"/>
    </themes>
    <stats>
        <totalViews>1597</totalViews>
        <lastWeekViews>6</lastWeekViews>
    </stats>
  </video>
  ...
</videos>

Lists all the videos available in our system.

HTTP Request

GET https://api.arrivalguides.com/api/xml/GetVideosFor?auth=YOUR_API_KEY&iso=LONDON&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
lang string Two letter language code
iso string True Destination ISO
iata string Destination IATA
videoWidth integer Video iframe width
videoHeight integer Video iframe height

Partners

Get a list of preferred partners

Returns a list of all the active Preferred Partners

curl "https://api.arrivalguides.com/api/xml/GetVideosFor?auth=YOUR_API_KEY&iso=LONDON&v=13"

The above command returns XML structured like this:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<preferredPartners>
    <preferredPartner>
        <iso>MUNICH</iso>
        <destinationId>274</destinationId>
        <sectionId/>
        <imageUrl>http://d1taxzywhomyrl.cloudfront.net/s3/ag-images-eu/14/fad9e7411199e0589609501bda516d5b.jpg?width=398&amp;height=245</imageUrl>
        <copyrightName/>
        <copyrightLink/>
        <startDate>2016-11-01T00:00:00Z</startDate>
        <endDate>2016-12-31T00:00:00Z</endDate>
        <position id="1" type="Top"/>
    </preferredPartner>
    ...
</preferredPartners>

HTTP Request

GET https://api.arrivalguides.com/xml/GetPreferredPartners?auth=YOUR_API_KEY&v=13

Query Parameters

Parameter Type Required Description
auth string True Authentication key
imgWidth integer Image width
imgHeight integer Image height