---
title: Getting Started with the Monetate Travel API
slug: js-api/monetate-travel-api-get-started
description: Overview of the requirements for implementing the Monetate JavaScript Travel API and its methods
image:  https://archbee-image-uploads.s3.amazonaws.com/ceIfEvQHzQk1IVxoRWUh7/K9eTL4jKm7UQINb6zNziJ-20250912-181225.png
docTags: 
createdAt: 2024-04-30T19:27:20.075Z
---

The Monetate Travel API allows you to pass data from your site to the Monetate platform. For best results you should track each page of your site. To do this, you must implement the following:

- [Monetate tag](docId\:zcx_p3d6ND2Rr5bJLOyUG): Allows Monetate to understand interactions on your site
- [Monetate Inspector browser plug-in](https://docs.monetate.com/docs/install-the-monetate-inspector-browser-plug-in): Verifies the functionality and placement of the Monetate tag on a page

## Passing Site Data to Monetate

The Travel API has nine total API methods, three for each type of travel site. Each method call has a series of attributes with information from the current page. Some of these attributes are required while some are optional. That said, you should include as many methods as you can to capture the information on your site pages. All attributes are represented as arrays, even if they only hold a single value.

### Additional Method Calls

In addition to the nine API methods specific to the Travel API, you must also implement two standard calls:

- [monetateQ](docId\:Jt7O1LQ8aUTjhFOLknLnV)
- [trackData](docId\:gcm0H169GurCQMv6sBota)

## Timing Expectations

The time needed to add the Monetate tag and the required method calls that are important to your business can vary. The number of method calls you need to add, your intended use of Monetate, and the skill set of the person completing these tasks can all affect how long it takes to complete the process. For more information about who should complete the various steps of this process and what to expect, see [Implementation User Roles](docId\:vaL7agKZFl5P5vGPak4Qv).

## Travel API Method Calls

You can call Monetate Travel API methods with the standard `window.monetateQ.push` feature. Additionally, this requires an object that contains all the attributes that you need to collect all of the required information on your site's page. You can create this object beforehand or during the method call. The fields in the object can be integers or strings.

Use the `add{travel_type}Search` methods when a customer searches on your site. Use the `add{travel_type}Review` methods when a customer has selected a cruise, hotel, or flight. Use the `add{travel_type}Booking` methods when a customer completes a purchase.

The `add{travel_type}Review` and `add{travel_type}Booking` methods also receive attributes with purchase information: product ID, quantity, price, currency, and order ID.

### Cruise Method Calls

This table contains the method calls related to cruise bookings.

| **Method**                                       | **Description**                                                                             |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| [addCruiseSearch](docId\:hRfSivVfXl62QQiHO1wF9)  | Passes information from your site to Monetate when a customer searches for a cruise         |
| [addCruiseReview](docId\:gD6KmNdpnNCbvEQEDMG5J)  | Passes information from your site to Monetate when a customer adds a cruise to the cart     |
| [addCruiseBooking](docId\:ALHMYxc1XTzo9fc3OhsLB) | Passes information from your site to Monetate when a customer completes purchasing a cruise |

### Hotel Method Calls

This table contains the method calls related to hotel bookings.

| **Method**                                     | **Description**                                                                                 |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [addHotelSearch](docId\:zedjttIcZlHXzYPcVengU) | Passes information from your site to Monetate when a customer searches for a hotel              |
| [addHotelReview](docId\:lerjrf4OwdVw5Nk0Bb4S2) | Passes information from your site to Monetate when a customer adds a hotel stay to the cart     |
| [addHotelBooking](docId:0NkCec5gqkH9OtOTTt75e) | Passes information from your site to Monetate when a customer completes purchasing a hotel stay |

### Flight Method Calls

This table contains the method calls related to airline ticket purchases.

| **Method**                                       | **Description**                                                                                    |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| [addFlightSearch](docId\:nPiKGERIWw6NubL358YmS)  | Passes information from your site to Monetate when a customer searches for a flight                |
| [addFlightReview](docId\:KtjygN0fgXOg8EAfUzfUx)  | Passes information from your site to Monetate when a customer adds a flight ticket to the cart     |
| [addFlightBooking](docId\:aVJZeY9RNBQE4nuj0ccjT) | Passes information from your site to Monetate when a customer completes purchasing a flight ticket |

