Free Travel Advisory API

Quickstart

This is a simple REST API for travel websites that replies with an UTF8 encoded JSON Object. This API provides you with a daily updated list of country advisories. These advisories contain a risk value which describes how dangerous a country is from a travellers perspective. This data is available for every country and as fresh as this website.

If you are looking for API travel information with more granular data, you might be interested in the Extended/Paid API.

Terms of Service

First of all, the service is free to use. This API described on this page is free of charge, you do not need any key. Just go ahead and use it. But to keep it that way, please comply with the following rules:

(1) This api comes without warranty or uptime promises. Uptime has been > 99,97% last year. However, servers can break; I might be on holiday at the same time. Who knows? So you should not use this API to operate a nuclear reactor and cache results to compensate for downtimes.

(2) Though I try to put great care in the coding, official travel advisories could be misinterpreted and show a wrong scoring. So you should not base potentially life threatening decisions on the API data alone.

(3) This API is designed for light traffic. If you wish to embed this data into your application, please consider a local and/or central caching. A few clients doing a few requests per day is totally fine. If it gets more, please contact me so I can provide you with a more scalable solution. We will work out a very fair pricing depending on your individual requirements. If in doubt, just ask.

(4) Attribution. Please refer to Travel-Advisory.info as source of data when you use the api in your application/website/app. It doesn't have to be a big bright badge, but it should be in context of the data shown. A page where you list contributors would also be totally fine.

Again: If possible, please cache your requests. The data is only updated once per day in the morning and doesn't change till the next day.

How to use

Essentially as simple as it gets.

Basic API Endpoint

https://www.travel-advisory.info/api

Calling this URL as GET will return the list of country we keep track of in JSON format.

You can also use the standard 'non-https' url http://www.travel-advisory.info/api at Port 80 if your client is not capable of handling SSL connections.

See example

Optional Parameter

https://www.travel-advisory.info/api?countrycode=AU

Using the api together with the optional parameter 'countrycode' and a single two-letter ISO countrycode will restrict the result list to a single country.

See Wikipedia for a comprehensive list of possible codes.

See example

Description of data structure

Here you see a list of the available fields, their format and meaning.

Example Code

		

		{
		  "api_status": {
			"request": {
			  "item": "de"
			},
			"reply": {
			  "cache": "renewed",
			  "code": 200,
			  "status": "ok",
			  "note": "The api works, we could match requested country code.",
			  "count": 1
			}
		  },
		  "data": {
			"DE": {
			  "iso_alpha2": "DE",
			  "name": "Germany",
			  "continent": "EU",
			  "advisory": {
				"score": 1.5,
				"sources_active": 4,
				"message": "Germany has a current risk level of 1.5 (out of 5). We Advise: Travelling Germany is (relatively) safe.",
				"updated": "2019-02-12 19:53:38",
				"source": "https:\/\/www.travel-advisory.info\/germany"
			  }
			}
		  }
		}