Search tours

Overview

Search available tours and activities with localized content and prices in your chosen currency. Supports free-text or geo search, plus filtering by date, language, price, category, rating, duration, and tour flags.

When to Use

  • Search results - Populate a tours listing or map view
  • Destination pages - Show activities available in a city or region
  • Category browsing - Filter tours by type, duration, or rating

What You Get

  • Tour listings - Titles, descriptions, images, and ratings
  • Localized content - Names and descriptions in the requested language
  • Prices - Amounts in the requested currency

Quick Start

Provide required language and currency query parameters. Returns a paginated list of matching tours. Narrow results with textSearch (or location[latitude]/location[longitude]/location[radiusKm], mutually exclusive with textSearch), dateRange[from]/dateRange[to], languages, price[min]/price[max], categories, rating[min]/rating[max], duration[min]/duration[max], and flags. Sort with sort[field]/sort[direction], and page through results with pagination[limit]/pagination[offset].

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

ISO language code for localized content

string
required

ISO 4217 currency code for prices

string

Free-text search term (location name, tour title, etc). Mutually exclusive with location[latitude]/location[longitude].

number

Geo filter latitude. Must be sent together with location[longitude] and location[radiusKm]. Mutually exclusive with textSearch.

number

Geo filter longitude. Must be sent together with location[latitude] and location[radiusKm].

number

Geo filter radius in kilometers around location[latitude]/location[longitude].

date

Only return tours offered on or after this date (YYYY-MM-DD).

date

Only return tours offered on or before this date (YYYY-MM-DD).

languages
array of strings

Filter to tours conducted in one or more of these ISO language codes (repeat the param per value, e.g. languages=en&languages=fr). Distinct from the required language param, which only controls localized content on the response.

languages
number

Minimum tour price, in the requested currency.

number

Maximum tour price, in the requested currency.

categories
array of integers

Filter to one or more category ids (repeat the param per value, e.g. categories=1&categories=2). See the category id/name pairs returned on each tour.

categories
number

Minimum overall tour rating (0-5).

number

Maximum overall tour rating (0-5).

integer

Minimum tour duration in minutes.

integer

Maximum tour duration in minutes.

flags
array of strings

Filter to tours matching one or more of these properties (repeat the param per value, e.g. flags=wheelchair&flags=pick-up).

flags
Allowed:
string
enum

Field to sort results by. popularity returns an internal recommended ranking and ignores sort[direction].

Allowed:
string
enum

Sort direction. Ignored when sort[field]=popularity.

Allowed:
integer

Maximum number of tours to return.

integer

Number of tours to skip, for pagination.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json