Browse activities

The activities catalogue holds tours, attractions, and experiences. Browse it to find a product, then open the product to see its bookable product-types and prices.

List products

GET/v3/HAPI/activities/products

Requires the activities:read scope.

Query parameters

Name	Type	Description
`query`	string	Free-text search over titles.
`city`	string	Filter by city.
`country`	string	Filter by country.
`category`	string	Filter by category.
`language`	string	Preferred content language.
`min_price`, `max_price`	number	Price range in USD.
`sort`	string	Sort order, e.g. `bestselling` or `price`.
`page`, `per_page`	integer	Paging (per_page default 50).

curl "https://api.hermeseus.com/v3/HAPI/activities/products?city=Tbilisi&sort=bestselling" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

{
  "object": "activity_product_list",
  "data": [
    {
      "object": "activity_product",
      "id": "act_4410",
      "title": "Old Town Walking Tour",
      "type": "Walking tour",
      "city": "Tbilisi",
      "from": { "amount": "29.00", "currency": "USD" },
      "image_url": "https://…",
      "images": [ "https://…" ]
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 128,
  "has_more": true
}

Get a product

GET/v3/HAPI/activities/products/{id}

Returns the full product, including its bookable product-types (ticket tiers, packages). You book a product-type, not the product itself.

{
  "object": "activity_product",
  "id": "act_4410",
  "title": "Old Town Walking Tour",
  "description": "…",
  "city": "Tbilisi",
  "country": "Georgia",
  "images": [ "https://…" ],
  "product_types": [
    {
      "object": "activity_product_type",
      "id": "apt_88213",
      "title": "Adult ticket",
      "from": { "amount": "29.00", "currency": "USD" }
    }
  ]
}

Prices are in USD. Catalogue prices are lead-in "from" prices. Read the real, per-traveller price for a date from availability and pricing before booking.

Was this page helpful?

Orders

Availability and pricing