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

Required: language, currency

Search (pick one): textSearch, or location[latitude]/location[longitude]/location[radiusKm]

Filters: dateRange[from]/dateRange[to], languages, price[min]/price[max], categories, rating[min]/rating[max], duration[min]/duration[max], flags

Sort: sort[field]/sort[direction]

Pagination: pagination[limit]/pagination[offset]

Returns a paginated list of matching tours.

Error codes

Product-operation codes are listed below. Shared authentication/access/rate-limit middleware can return common codes such as 401, 40301 or 4290. HTTP status and error code are separate; do not parse message text.

CodeMeaning
71001invalid experience request
71002experience not found
71003experiences provider request failed
71004experiences provider request timed out
71005experience request is unauthorized
71006experience request is forbidden
71007experiences service is temporarily unavailable
71099failed to retrieve experiences
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 partner-facing selling price, in the requested currency. Bounds are interpreted using the same cent rounding as the returned price.

number

Maximum partner-facing selling price, in the requested currency. Bounds are interpreted using the same cent rounding as the returned price.

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