Experiences

Search live experiences in a destination.

Search live experiences in a destination. Requires partner access; returns 503 AGENT_ACCESS_NOT_APPROVED until enabled. Rate limited. Sandbox: X-Sandbox: true returns fixture data.

get/experiences

Request

  • Base URL: https://ecoaloha.com/api/v1
  • URL: https://ecoaloha.com/api/v1/experiences
  • Auth: none required

Query parameters

destinationId'amsterdam' | 'anchorage' | 'antalya' | 'athens' | 'auckland' | 'bali' | 'banff' | 'bangkok' | 'barcelona' | 'bergen' | 'berlin' | 'bilbao' | 'bordeaux' | 'boston' | 'brisbane' | 'bruges' | 'brussels' | 'budapest' | 'buenos-aires' | 'cairo' | 'cancun' | 'cape-town' | 'cappadocia' | 'caribbean-coast' | 'cartagena' | 'central-pacific' | 'chiang-mai' | 'chicago' | 'christchurch' | 'cologne' | 'colombo' | 'copenhagen' | 'crete' | 'cusco' | 'denver' | 'dubai' | 'dublin' | 'dubrovnik' | 'edinburgh' | 'florence' | 'frankfurt' | 'funchal' | 'geneva' | 'guanacaste-northwest' | 'hamburg' | 'hanoi' | 'helsinki' | 'ho-chi-minh-city' | 'hobart' | 'honolulu' | 'innsbruck' | 'interlaken' | 'istanbul' | 'jaco' | 'kathmandu' | 'krakow' | 'kuala-lumpur' | 'kyoto' | 'la-fortuna' | 'las-vegas' | 'lima' | 'limon' | 'lisbon' | 'ljubljana' | 'london' | 'los-angeles' | 'lucerne' | 'lyon' | 'madrid' | 'malaga' | 'manchester' | 'marrakech' | 'marseille' | 'melbourne' | 'mexico-city' | 'miami' | 'milan' | 'monteverde' | 'montreal' | 'munich' | 'muscat' | 'nairobi' | 'naples' | 'new-orleans' | 'new-york' | 'nice' | 'oaxaca' | 'osaka' | 'oslo' | 'palermo' | 'palma-de-mallorca' | 'paris' | 'perth' | 'phuket' | 'ponta-delgada' | 'portland' | 'porto' | 'prague' | 'puntarenas' | 'quebec-city' | 'queenstown' | 'quepos' | 'quito' | 'reykjavik' | 'rio-de-janeiro' | 'rome' | 'rotterdam' | 'salzburg' | 'san-diego' | 'san-francisco' | 'san-jose' | 'santa-teresa' | 'santiago' | 'santorini' | 'seattle' | 'seoul' | 'seville' | 'singapore' | 'split' | 'stockholm' | 'sydney' | 'taipei' | 'tokyo' | 'toronto' | 'tromso' | 'valencia' | 'vancouver' | 'venice' | 'vienna' | 'warsaw' | 'washington-dc' | 'zagreb' | 'zurich' required

Approved destination id from list_destinations.

currency'EUR' | 'USD' | 'GBP'

Display currency for prices.

searchTermstring

Free-text filter on title.

startDatestring date

Earliest travel date (YYYY-MM-DD).

endDatestring date

Latest travel date (YYYY-MM-DD).

minDurationnumber

Minimum duration in minutes.

maxDurationnumber

Maximum duration in minutes.

minPricenumber

Minimum starting price in currency.

maxPricenumber

Maximum starting price in currency.

sort'recommended' | 'price-asc' | 'price-desc' | 'rating' | 'duration'

Sort order.

intereststring

Activity keyword. One of the 10 topic keywords filters by Viator tags: eco (Eco tours), nature (Nature & parks), hik (Hiking & trails), bike (Cycling), kayak (Kayak & paddle), adventure (Adventure), wildlife (Wildlife), garden (Gardens), walking (Walking tours), food (Local food). Any other word filters title and description by substring.

cursorstring

Opaque cursor from nextCursor of the previous page. Omit for the first page.

Example:MjU=
limitinteger

Page size, 1 to 50.

Headers

X-Sandbox'true'

Sandbox / test mode: fixture data, no partner call, no quota, no writes.

Response

One page of experiences.

nextCursorstring nullable

Cursor for the next page. null when this is the last page.

Example response

{
  "data": [
    {
      "id": "5010SYDNEY"
    }
  ],
  "nextCursor": "MjU="
}

Changes

No recorded changes to this operation across all 1 revision of this API.