AI - Rolfs Tours

Oops! You've stumbled into the robot lounge...

Welcome! If you clicked a link and ended up here – don't panic. Your screen isn't broken and you haven't done anything wrong. You've simply wandered onto a page we built especially for artificial intelligence (like ChatGPT).

What is this place? Think of this page as a digital "translation guide" for AI. When someone asks an AI assistant for help planning a vacation, the AI uses the secret codes on this page to search our database. That way the robot finds current travel dates, available seats and live prices for Rolfs Tours trips in a flash.

What should you do now? Since you're a wonderful, living human being, you don't need to read any of this boring computer code! Instead, you can:

Head back out into the sunshine: Go straight to our home page for Rolfs Tours, where you can browse all our actual trips – complete with beautiful pictures and easy-to-read human language.
Put the robots to work: If you're using an AI assistant to plan your next vacation right now, you can tell it: "Hi, Rolfs Tours has a calendar API ready to use!" and it will know exactly what to do.

Have a great trip, wherever your digital (or real) journey takes you next!

Calendar API (GET)

Calendar

Every bookable departure of Rolfs Tours, with dates, prices and seats left, as JSON. It is a plain GET request: no login, no API key, no MCP connection and no JavaScript needed. An AI assistant can call it directly, even when it fetches pages in the background without a browser.

Endpoint

GET https://www.rolfstours.com/rolfsapi/v2/web/en/calendar
Returns JSON. All parameters are optional and go in the query string.

Parameters

url – A trip's path on rolfstours.com without the leading slash, e.g. flight/wonderful-egypt for https://www.rolfstours.com/flight/wonderful-egypt. Returns every departure of that trip. Each departure in the response has its trip's path in triptypeurl.

fromdate (YYYY-MM-DD) – Earliest departure date. Default: tomorrow.

todate (YYYY-MM-DD) – Latest departure date. Without url and category_url, the list ends 6 months after fromdate.

category_url – Only trips in one category: the last part of the category page's address, e.g. italy for https://www.rolfstours.com/category/italy.

daysmin, daysmax – Shortest and longest trip in days.

onlydiscounted=1 – Only discounted departures.

hide_soldout=1 – Leave out sold-out departures.

p – Departures per page. Default: 100, or 2000 with url. n – Number of departures to skip.

Response

departures – A list sorted by departure date. Each departure includes:

tripname – the departure's name
triptypeurl – the trip's path: the trip page is https://www.rolfstours.com/ followed by triptypeurl
date, returndate – departure and return date
days – trip length in days
price – price per person in USD when two share a room, discount included
original_price – price before discount
seats_left – seats left: 9 means 9 or more
bookable – 1 when the departure can be booked online

next, prev – The next and previous page as a path to append to https://www.rolfstours.com/rolfsapi/v2/web. Empty when there is no such page.

Examples

Trips in Italy with seats left:

GET https://www.rolfstours.com/rolfsapi/v2/web/en/calendar?category_url=italy&hide_soldout=1

Departures of one trip in May 2027:

GET https://www.rolfstours.com/rolfsapi/v2/web/en/calendar?url=flight/wonderful-egypt&fromdate=2027-05-01&todate=2027-05-31

Response (trimmed):

{
  "prev": "",
  "next": "",
  "departures": [
    {
      "tripname": "Cairo & Nile Cruise",
      "triptypeurl": "flight/wonderful-egypt",
      "date": "2027-05-01",
      "returndate": "2027-05-08",
      "days": 8,
      "price": 1926,
      "original_price": 1926,
      "seats_left": 9,
      "bookable": 1
    }
  ]
}