Public APIs

Izi

Audio guide for travellers. Starting from API version 1.2.3, the “Museum Tours” feature is introduced extending the concept of navigational story to Museum’s collections for showing the visitor “navigational pictures/audio” between exhibits and allowing the visitor to understand where to go next. More than one navigational stories are allowed between two exhibits.

Visit API

📚 Documentation & Examples

Everything you need to integrate with Izi

🚀 Quick Start Examples

Izi Javascript Examplejavascript

// Izi API Example
const response = await fetch('http://api-docs.izi.travel/', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data);

Introduction to Izi.travel API

Izi.travel API is a free public API designed for creating rich multimedia guides, tours, and experiences for destinations all around the world. It combines mobile, web, and social technologies to provide a complete solution for creating interactive and engaging guides that enhance any travel experience.

In this blog post, we will be exploring the different endpoints and methods provided by the Izi.travel API. We will be using JavaScript as our programming language of choice to demonstrate how to interact with the API.

API Endpoints

The Izi.travel API provides several endpoints that can be used to retrieve information on different destinations, city tours, and audio guides. The endpoints are as follows:

/cities - Retrieves a list of all the cities that have tours available on the platform.
/tours - Retrieves a list of all the tours available in a specific city.
/audio_guides - Retrieves a list of all the audio guides available in a specific city.
/city_details - Retrieves details about a specific city.
/tour_details - Retrieves details about a specific tour.
/audio_guide_details - Retrieves details about a specific audio guide.

Making Requests to the API

To make requests to the Izi.travel API, we will be using the built-in fetch method in JavaScript. The fetch method is a modern way of making HTTP requests in web applications. Here's an example code snippet that shows how to make a request to the /cities endpoint:

fetch('https://api-docs.izi.travel/cities')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

The code above sends a GET request to the /cities endpoint. It then parses the response data into a JSON object and logs it to the console. If there's an error with the request, it catches the error and logs it to the console.

Using Query Parameters

You can also use query parameters to filter the results returned by the API. For example, if you only want to retrieve tours in a particular city, you can use the city_id query parameter as shown below:

fetch('https://api-docs.izi.travel/tours?city_id=123')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

The code above sends a GET request to the /tours endpoint with the city_id query parameter set to 123. It then logs the response data to the console.

Conclusion

In this blog post, we've explored the different endpoints provided by the Izi.travel API. We've also demonstrated how to make HTTP requests to the API using JavaScript and how to use query parameters to filter the results returned by the API. With this information, you can start building rich multimedia guides, tours, and experiences to enhance any travel experience.

📊 30-Day Uptime History

Daily uptime tracking showing online vs offline minutes

Online

Offline

Related APIs in Transportation